From c9af98115a3c4431c7315e71b2450616225a0881 Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Fri, 10 Jul 2026 17:08:19 +0000 Subject: [PATCH] docs: document oz agent run-cloud harness flags 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 --- src/content/docs/reference/cli/index.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index 6cc6a1d5b..d6c3201e2 100644 --- a/src/content/docs/reference/cli/index.mdx +++ b/src/content/docs/reference/cli/index.mdx @@ -271,6 +271,9 @@ oz agent run-cloud \ * `--attach ` — attach an image file to the agent query. Can be repeated (maximum 5). * `--computer-use` / `--no-computer-use` — enable or disable [Computer Use](/agent-platform/capabilities/computer-use/) for this run. * `--file ` (`-f`) — load run configuration from a YAML or JSON file. +* `--harness ` — choose the [execution harness](/platform/harnesses/) for the run: `oz` (default, Warp's built-in agent infrastructure), `claude` (Claude Code), or `codex`. +* `--claude-auth-secret ` — name of the [Warp-managed secret](/platform/harnesses/authentication/) that authenticates the Claude Code harness. Only valid with `--harness claude`. +* `--codex-auth-secret ` — name of the [Warp-managed secret](/platform/harnesses/authentication/) that authenticates the Codex harness. Only valid with `--harness codex`. **Key differences from `run`** @@ -317,6 +320,20 @@ oz agent run-cloud \ You can reuse saved prompts with `--saved-prompt`, and reference notebooks, workflows, and rules inline in any `--prompt` string. See [Referencing Warp Drive objects](/reference/cli/warp-drive/) for details. +#### Choosing an execution harness + +By default, cloud runs use Warp's built-in `oz` harness. To delegate the run to a third-party coding agent, pass `--harness` with `claude` (Claude Code) or `codex`, along with the matching auth secret: + +```sh +oz agent run-cloud \ + --environment \ + --harness claude \ + --claude-auth-secret \ + --prompt "review the latest PR" +``` + +Create the auth secret first with `oz secret create claude api-key ` (or `oz secret create codex api-key ` for Codex). See [Third-party cloud agent authentication](/platform/harnesses/authentication/) for the full setup. + ## Using agent profiles Agent profiles control what the agent can do, how it behaves, and where it can act. Use the `--profile` flag with `oz agent run` to apply a specific profile.