Skip to content

docs: document oz agent run-cloud harness flags#322

Draft
hongyi-chen wants to merge 1 commit into
mainfrom
docs/cli-run-cloud-harness-flags
Draft

docs: document oz agent run-cloud harness flags#322
hongyi-chen wants to merge 1 commit into
mainfrom
docs/cli-run-cloud-harness-flags

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

Document the --harness, --claude-auth-secret, and --codex-auth-secret flags for oz agent run-cloud in the CLI reference. These flags let you delegate a cloud run to a third-party coding agent (Claude Code or Codex) with the matching Warp-managed auth secret.

What changed

  • Added the three flags to the oz agent run-cloud Key flags list in reference/cli/index.mdx.
  • Added a Choosing an execution harness subsection with a runnable example and a cross-link to the third-party cloud agent authentication page.

Source

Flags defined in warp:crates/warp_cli/src/agent.rs (RunCloudArgs). All three are non-hidden (public) and the oz/claude/codex harness values are GA for cloud runs (Harness::should_display_in_help_text).

Audit context

Found via the missing_docs drift-watch audit (surface_changes: new CLI flags on the agent command).

Conversation: https://staging.warp.dev/conversation/693d79a7-7cf9-4a67-b070-2aeb15986da6
Run: https://oz.staging.warp.dev/runs/019f4cf8-d573-7793-af78-d05ffd29cfd5

This PR was generated with Oz.

Add --harness, --claude-auth-secret, and --codex-auth-secret to the
oz agent run-cloud CLI reference, plus a "Choosing an execution harness"
example.

Co-Authored-By: Oz <oz-agent@warp.dev>
@vercel

vercel Bot commented Jul 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 10, 2026 5:11pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants