oz_agent_run
Run a local Warp Oz AI agent for coding tasks like refactoring, testing, debugging, or explaining code. Agent can create or modify files in the workspace and uses no cloud credits.
Instructions
Run a Warp Oz AI agent locally in the host workspace and return its full output synchronously. Runs oz agent run with your prompt and blocks until the agent finishes. Use for local coding tasks — refactor, write/run tests, debug, explain code — that should NOT consume cloud credits; for cloud execution call oz_agent_run_cloud instead. NOT read-only: the agent may create or modify files in the workspace. Requires the oz CLI on PATH (install Warp).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | AI model id to use, from `oz_list_models` (e.g. `claude-4-8-opus-max`). Omit to use the configured default (`auto` lets Warp choose). | |
| skill | No | Agent skill id from the 7-stage pipeline (e.g. `5-test-agent`). Omit to let the CLI choose one based on the prompt. | |
| prompt | Yes | Natural-language instruction for the agent, e.g. "add unit tests for src/auth.ts". | |
| profile | No | Oz agent profile name (managed in the Warp app under Settings → AI → Profiles). Omit to use the default profile. |