From 77d364dac55574f7f6df5a60551aa7afa540a80f Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Tue, 8 Sep 2026 05:31:05 +0000 Subject: [PATCH] docs: list gemini as a factory harness type and pair --claude-auth-secret with the claude-code alias Follow-up to #689, applying the two review suggestions that were not accepted there: - Harness identifiers: the factory definition bullet now lists the values the schema actually validates (oz, claude, codex, gemini plus the claude-code alias) instead of implying factories accept only the shared identifiers, matching factory-as-code.mdx. - CLI reference: --claude-auth-secret no longer says it is only valid with --harness claude, since the previous bullet documents claude-code as an accepted alias for the same harness. Co-Authored-By: Warp --- src/content/docs/platform/harnesses/index.mdx | 4 ++-- src/content/docs/reference/cli/index.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/platform/harnesses/index.mdx b/src/content/docs/platform/harnesses/index.mdx index 80b34e26e..98a629bbd 100644 --- a/src/content/docs/platform/harnesses/index.mdx +++ b/src/content/docs/platform/harnesses/index.mdx @@ -58,11 +58,11 @@ Set the `harness` field on the agent config to one of the [harness identifiers]( ## Harness identifiers -Surfaces that take the harness as a string all use the same identifiers: `oz` for the Warp Agent, `claude` for Claude Code, and `codex` for Codex. Write `claude` for Claude Code — not `claude-code`: +Surfaces that take the harness as a string use `oz` for the Warp Agent, `claude` for Claude Code, and `codex` for Codex. Write `claude` for Claude Code — not `claude-code` — unless the surface explicitly accepts that alias: * **API and SDK** — the agent config's `harness.type` accepts `oz`, `claude`, or `codex`. * **CLI** — `oz agent run-cloud --harness` accepts the same identifiers, plus `claude-code` as an alias for `claude`. -* **Factory definition files** — [`harness.type`](/factories/factory-as-code/#agentdefaultsharness) accepts the same identifiers, plus the `claude-code` alias. +* **Factory definition files** — [`harness.type`](/factories/factory-as-code/#agentdefaultsharness) accepts `oz`, `claude`, `codex`, or `gemini`, plus `claude-code` as an alias for `claude`. Where the alias is accepted, it selects the same Claude Code harness as `claude`. Everywhere else — including the API — only the canonical identifiers are valid, so prefer them in anything you script, sync, or store. diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index 803c677ea..e301e9259 100644 --- a/src/content/docs/reference/cli/index.mdx +++ b/src/content/docs/reference/cli/index.mdx @@ -274,7 +274,7 @@ 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](/agents/capabilities/computer-use/) for this run. * `--harness ` — choose the [execution harness](/platform/harnesses/) for the run: `oz` (default, the Warp Agent), `claude` (Claude Code), or `codex` (Codex). `claude-code` is accepted as an alias for `claude`. See [harness identifiers](/platform/harnesses/#harness-identifiers). -* `--claude-auth-secret ` — name of the [Warp-managed secret](/platform/secrets/) that authenticates the Claude Code harness. Only valid with `--harness claude`. See [Third-party cloud agent authentication](/platform/harnesses/authentication/). +* `--claude-auth-secret ` — name of the [Warp-managed secret](/platform/secrets/) that authenticates the Claude Code harness. Use with `--harness claude` or the `--harness claude-code` alias. See [Third-party cloud agent authentication](/platform/harnesses/authentication/). * `--codex-auth-secret ` — name of the [Warp-managed secret](/platform/secrets/) that authenticates the Codex harness. Only valid with `--harness codex`. See [Third-party cloud agent authentication](/platform/harnesses/authentication/). * `--file ` (`-f`) — load run configuration from a YAML or JSON file.