Skip to content

docs: document harness flags on oz agent run-cloud#331

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

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

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

Summary

Documents the third-party harness flags on oz agent run-cloud in the CLI reference. Surfaced by the missing_docs drift-watch audit (new CLI flags since last snapshot).

The harnesses feature (running Claude Code or Codex as cloud agents) is GA and documented under platform/harnesses/, but the CLI reference didn't cover launching a harness run from the Oz CLI. This adds:

  • --harness <HARNESS> — choose the execution harness (oz default, claude, codex).
  • --claude-auth-secret <NAME> — Warp-managed secret for the Claude Code harness (only valid with --harness claude).
  • --codex-auth-secret <NAME> — Warp-managed secret for the Codex harness (only valid with --harness codex).

Plus a worked example and cross-links to the harness authentication and secrets docs.

Source: warp:crates/warp_cli/src/agent.rs (RunCloudArgs, Harness).

Validation

  • npm run build passes.

Conversation: https://staging.warp.dev/conversation/0ee78198-1342-4558-b918-b484f4655005
Run: https://oz.staging.warp.dev/runs/019f5c6b-ee12-75f1-a353-e0ef6e3edd4f

This PR was generated with Oz.

Add --harness, --claude-auth-secret, and --codex-auth-secret to the
oz agent run-cloud key flags in the CLI reference, plus an example of
launching a third-party harness cloud run and cross-links to the
harness authentication docs.

Co-Authored-By: Oz <oz-agent@warp.dev>
@hongyi-chen hongyi-chen requested review from bnavetta and ianhodge July 13, 2026 17:10
@cla-bot cla-bot Bot added the cla-signed label Jul 13, 2026
@vercel

vercel Bot commented Jul 13, 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 13, 2026 5:12pm

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.

1 participant