Agents > Harnesses
Warp Agent with Oz
# Warp Agent with Oz Warp Agent is the harness Warp builds and ships with Oz. It's the default for every cloud agent run unless you pick another harness, and it's the only harness that can spawn cross-harness subagents (for example, a Warp Agent parent dispatching a Claude Code or Codex child). Warp Agent is the same agent runtime that powers Agent Mode in the Warp terminal. Running it as a cloud harness gives you the same behavior — model routing, tool access, Skills, Rules, Memory — without tying execution to a single laptop. ## Key features * **Multi-model auto-routing** - Routes between Anthropic, OpenAI, Google, and Fireworks-hosted models. Choose a specific model, or let Warp pick via `auto`, `auto-efficient`, `auto-genius`, or `auto-open`. See [Model choice](/agent-platform/capabilities/model-choice/) for the full catalog. * **Full terminal and tool access** - Runs commands, edits files, reads logs, executes tests, navigates repos, and calls MCP servers — the same toolbelt Warp Agent uses locally. * **Platform-native context** - Reads [Codebase Context](/agent-platform/capabilities/codebase-context/), applies [Rules](/agent-platform/capabilities/rules/), reuses saved [Skills](/agent-platform/capabilities/skills/), and respects Memory and Warp Drive context with no extra setup. * **Multi-repo execution** - Clones every repo configured on the [environment](/agent-platform/cloud-agents/environments/) and works across them in a single run. * **Cross-harness orchestration parent** - A Warp Agent parent run can spawn Claude Code or Codex [subagents](/agent-platform/cloud-agents/overview/) and coordinate their outputs. Other harnesses cannot act as parents in a multi-harness orchestration. * **No extra credentials** - Warp Agent uses your existing Warp account and credits. There's no separate API key to configure. ## How it works Warp Agent is the same agent runtime as Agent Mode in the Warp terminal: it plans, calls tools, edits code, runs tests, and reports progress. The cloud platform adds the [environment](/agent-platform/cloud-agents/environments/), triggers, observability, and team governance around the run, and the transcript is inspectable in real time and replayable afterward from the [Oz dashboard](/agent-platform/cloud-agents/managing-cloud-agents/). Team admins can disable any harness for their workspace. Users on that team can only start runs with the harnesses that remain enabled. ### Available models Warp Agent supports the full Warp model catalog. Configure the model per [Agent Profile](/agent-platform/capabilities/agent-profiles-permissions/), or pick one at run time. See [Model choice](/agent-platform/capabilities/model-choice/) for the supported model IDs, including the `auto`, `auto-efficient`, `auto-genius`, and `auto-open` routing options. ### Cross-harness orchestration Warp Agent is the orchestration host for multi-harness runs. A typical pattern: 1. A Warp Agent parent run analyzes a task and breaks it into subtasks. 2. The parent dispatches Claude Code subagents for code-review-heavy steps and Codex subagents for high-volume edits. 3. The parent collects results, resolves conflicts, and returns a single final output (a PR, a report, a Slack reply). Subagents run in the same environment as the parent and share the same secrets, MCP servers, and integrations. The transcript shows the full tree, so reviewers can see exactly which subagent did what. ## When to choose Warp Agent * The task spans multiple repos, languages, or domains. * You want model auto-routing instead of pinning one provider. * The run needs to orchestrate other harnesses as subagents. * You want the deepest integration with Warp's platform features (Skills, Rules, Memory, Codebase Context). * You're not sure which harness fits — Warp Agent is the safe default and can delegate to other harnesses when it decides that's the better fit. ## Starting a Warp Agent run Warp Agent is the default, so there's nothing extra to configure. * **Warp app** - Start a cloud agent run from the input. The **Agent harness** dropdown defaults to **Warp Agent**. * **Oz web app** - On a new run or new schedule pane, leave the **Harness** field set to **Warp Agent**. * **Oz CLI** - Run `oz agent run-cloud --prompt "..."` with no `--harness` flag, or pass `--harness oz` explicitly. * **API and SDK** - Omit the `harness` field on the agent config, or set it to `oz`. See the [API reference](/reference/api-and-sdk/). For a complete walkthrough, see the [Cloud agents quickstart](/agent-platform/cloud-agents/quickstart/). ## Related pages * [Harnesses in Oz](/agent-platform/cloud-agents/harnesses/) — pick between Warp Agent, Claude Code, and Codex. * [Claude Code with Oz](/agent-platform/cloud-agents/harnesses/claude-code/) — Claude Code as a cloud harness. * [Codex with Oz](/agent-platform/cloud-agents/harnesses/codex/) — Codex as a cloud harness. * [Model choice](/agent-platform/capabilities/model-choice/) — the model catalog Warp Agent routes across. * [Agent Profiles and permissions](/agent-platform/capabilities/agent-profiles-permissions/) — configure the default model, autonomy, and tool access for Warp Agent. * [Skills as agents](/agent-platform/cloud-agents/skills-as-agents/) — turn a saved skill into a reusable Warp Agent run.Warp Agent is Oz's default harness. It routes across leading models, has full terminal access, and is the only harness that can orchestrate subagents.
Warp Agent is the harness Warp builds and ships with Oz. It’s the default for every cloud agent run unless you pick another harness, and it’s the only harness that can spawn cross-harness subagents (for example, a Warp Agent parent dispatching a Claude Code or Codex child).
Warp Agent is the same agent runtime that powers Agent Mode in the Warp terminal. Running it as a cloud harness gives you the same behavior — model routing, tool access, Skills, Rules, Memory — without tying execution to a single laptop.
Key features
Section titled “Key features”- Multi-model auto-routing - Routes between Anthropic, OpenAI, Google, and Fireworks-hosted models. Choose a specific model, or let Warp pick via
auto,auto-efficient,auto-genius, orauto-open. See Model choice for the full catalog. - Full terminal and tool access - Runs commands, edits files, reads logs, executes tests, navigates repos, and calls MCP servers — the same toolbelt Warp Agent uses locally.
- Platform-native context - Reads Codebase Context, applies Rules, reuses saved Skills, and respects Memory and Warp Drive context with no extra setup.
- Multi-repo execution - Clones every repo configured on the environment and works across them in a single run.
- Cross-harness orchestration parent - A Warp Agent parent run can spawn Claude Code or Codex subagents and coordinate their outputs. Other harnesses cannot act as parents in a multi-harness orchestration.
- No extra credentials - Warp Agent uses your existing Warp account and credits. There’s no separate API key to configure.
How it works
Section titled “How it works”Warp Agent is the same agent runtime as Agent Mode in the Warp terminal: it plans, calls tools, edits code, runs tests, and reports progress. The cloud platform adds the environment, triggers, observability, and team governance around the run, and the transcript is inspectable in real time and replayable afterward from the Oz dashboard.
Team admins can disable any harness for their workspace. Users on that team can only start runs with the harnesses that remain enabled.
Available models
Section titled “Available models”Warp Agent supports the full Warp model catalog. Configure the model per Agent Profile, or pick one at run time. See Model choice for the supported model IDs, including the auto, auto-efficient, auto-genius, and auto-open routing options.
Cross-harness orchestration
Section titled “Cross-harness orchestration”Warp Agent is the orchestration host for multi-harness runs. A typical pattern:
- A Warp Agent parent run analyzes a task and breaks it into subtasks.
- The parent dispatches Claude Code subagents for code-review-heavy steps and Codex subagents for high-volume edits.
- The parent collects results, resolves conflicts, and returns a single final output (a PR, a report, a Slack reply).
Subagents run in the same environment as the parent and share the same secrets, MCP servers, and integrations. The transcript shows the full tree, so reviewers can see exactly which subagent did what.
When to choose Warp Agent
Section titled “When to choose Warp Agent”- The task spans multiple repos, languages, or domains.
- You want model auto-routing instead of pinning one provider.
- The run needs to orchestrate other harnesses as subagents.
- You want the deepest integration with Warp’s platform features (Skills, Rules, Memory, Codebase Context).
- You’re not sure which harness fits — Warp Agent is the safe default and can delegate to other harnesses when it decides that’s the better fit.
Starting a Warp Agent run
Section titled “Starting a Warp Agent run”Warp Agent is the default, so there’s nothing extra to configure.
- Warp app - Start a cloud agent run from the input. The Agent harness dropdown defaults to Warp Agent.
- Oz web app - On a new run or new schedule pane, leave the Harness field set to Warp Agent.
- Oz CLI - Run
oz agent run-cloud --prompt "..."with no--harnessflag, or pass--harness ozexplicitly. - API and SDK - Omit the
harnessfield on the agent config, or set it tooz. See the API reference.
For a complete walkthrough, see the Cloud agents quickstart.
Related pages
Section titled “Related pages”- Harnesses in Oz — pick between Warp Agent, Claude Code, and Codex.
- Claude Code with Oz — Claude Code as a cloud harness.
- Codex with Oz — Codex as a cloud harness.
- Model choice — the model catalog Warp Agent routes across.
- Agent Profiles and permissions — configure the default model, autonomy, and tool access for Warp Agent.
- Skills as agents — turn a saved skill into a reusable Warp Agent run.