Skip to content

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

Merged
hongyi-chen merged 2 commits into
mainfrom
oz/docs-cli-harness-flags
Jul 15, 2026
Merged

docs: document harness flags on oz agent run-cloud#331
hongyi-chen merged 2 commits 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 15, 2026 10:26pm

Request Review

@oz-for-oss

oz-for-oss Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

@hongyi-chen

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@oz-for-oss oz-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

Documents the oz agent run-cloud harness selection and harness-specific auth-secret flags, adds a worked Claude Code example, and links to the existing harness authentication and secrets documentation.

Concerns

  • No blocking correctness, security, or spec-alignment concerns found. spec_context.md reports no approved or repository spec context for this PR.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@hongyi-chen hongyi-chen merged commit 9d3ed43 into main Jul 15, 2026
8 checks passed
@hongyi-chen hongyi-chen deleted the oz/docs-cli-harness-flags branch July 15, 2026 22:32
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