Agents
Agents overview
# Agents overview import VideoEmbed from '@components/VideoEmbed.astro'; The **Warp Agent** is Warp's built-in coding agent. It works through multi-step tasks on its own, running commands in a real terminal and using the output to decide what to do next. You stay in the loop, approving actions and reviewing diffs before anything lands. --- ## Where to use the Warp Agent You reach the same agent three ways. Which one you pick depends on where you're working, not on what the agent can do. * **In the Warp app** - The full experience, with code review, agent management, and the terminal beside your conversation. * [**In any terminal, with the Warp Agent CLI**](/agents/cli/) - Run the `warp` command to start a conversation in any terminal emulator, over SSH, or on a machine where the Warp app isn't installed. * [**In the cloud, as a cloud agent**](/platform/) - Run the agent in the background from a trigger, a schedule, or an integration, without keeping a session open. Cloud agents run on [Oz](/platform/overview/), Warp's platform for environments, triggers, orchestration, and observability. --- ## What makes the Warp Agent different * **It works in a real terminal** - The agent runs shell commands, reads live output, and drives interactive programs like REPLs, database shells, and full-screen apps. See [Full terminal use](/agents/capabilities/full-terminal-use/). * **Your context follows it everywhere** - [Rules](/agents/capabilities/rules/), [Skills](/agents/capabilities/skills/), [MCP servers](/agents/capabilities/mcp/), and [Codebase Context](/agents/capabilities/codebase-context/) apply the same way in the app, the CLI, and the cloud. * **Interactive or delegated, and you can switch mid-task** - Steer a conversation while it runs, or [hand it off](/platform/handoff/) to a cloud agent and pick it back up locally when it's done. * **You approve before anything lands** - The agent asks before it runs commands, edits files, or calls MCP servers. Set how much it does on its own with [Agent Profiles and permissions](/agents/capabilities/agent-profiles-permissions/), and review generated changes in [interactive code review](/agents/local-agents/interactive-code-review/). * **Many agents at once** - Run several conversations in parallel and track them in the [Agent Management Panel](/platform/managing-cloud-agents/), or use [orchestration](/platform/orchestration/) to have a parent agent spawn and coordinate children. <VideoEmbed url="https://youtu.be/qiQtD1jPF6s" title="Agent Mode Overview" /> **Try this prompt** — [_open in Warp_](https://app.warp.dev/drive/prompt/Clone-and-install-Warps-themes-repository-PkK9Zw16SCD3JKzOUoGuj4) ```text Detect my current operating system. Based on that, navigate to the appropriate Warp themes directory (e.g. ~/.warp/ on macOS). Then, clone the official Warp themes repository using SSH (git@github.com:warpdotdev/themes.git) into that directory, following the structure and instructions provided in the repo's README. If SSH does not work, try HTTPS (https://github.com/warpdotdev/themes.git) or via the GitHub CLI (gh repo clone warpdotdev/themes). ``` --- ## Third-party CLI agents Separately from the Warp Agent, Warp gives third-party CLI coding agents first-class support. Run Claude Code, Codex, OpenCode, and others inside Warp and get rich input, agent notifications, inline code review, and remote session control. → [Learn about third-party CLI agents](/agents/cli-agents/overview/) --- ## Where to go next * [**Interacting with agents**](/agents/local-agents/interacting-with-agents/) - Conversations, context, code review, and voice in the Warp app. * [**Agent capabilities**](/agents/capabilities/) - Planning, skills, rules, MCP servers, task lists, and model choice. * [**Warp Agent CLI quickstart**](/agents/cli/quickstart/) - Install the CLI and run your first conversation. * [**Cloud agents quickstart**](/platform/quickstart/) - Run your first agent in the cloud, or put one on a [schedule](/platform/triggers/scheduled-agents/). For a comparison of triggers across schedules, Slack, Linear, GitHub Actions, the CLI, and the API, see [Run unattended agents](/guides/agent-workflows/how-to-run-unattended-agents/). * [**Agent FAQs**](/agents/getting-started/faqs/) - Models, privacy, credits, and limits. --- ## Open source Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/master/LICENSE-AGPL), so the editor and terminal that host your agents are fully auditable. See [Contributing to Warp](/support-and-community/community/contributing/).Tell me about this feature: https://docs.warp.dev/agents/The Warp Agent runs commands in a real terminal, carries your context across every surface, and works interactively or in the background.
The Warp Agent is Warp’s built-in coding agent. It works through multi-step tasks on its own, running commands in a real terminal and using the output to decide what to do next. You stay in the loop, approving actions and reviewing diffs before anything lands.
Where to use the Warp Agent
Section titled “Where to use the Warp Agent”You reach the same agent three ways. Which one you pick depends on where you’re working, not on what the agent can do.
- In the Warp app - The full experience, with code review, agent management, and the terminal beside your conversation.
- In any terminal, with the Warp Agent CLI - Run the
warpcommand to start a conversation in any terminal emulator, over SSH, or on a machine where the Warp app isn’t installed. - In the cloud, as a cloud agent - Run the agent in the background from a trigger, a schedule, or an integration, without keeping a session open. Cloud agents run on Oz, Warp’s platform for environments, triggers, orchestration, and observability.
What makes the Warp Agent different
Section titled “What makes the Warp Agent different”- It works in a real terminal - The agent runs shell commands, reads live output, and drives interactive programs like REPLs, database shells, and full-screen apps. See Full terminal use.
- Your context follows it everywhere - Rules, Skills, MCP servers, and Codebase Context apply the same way in the app, the CLI, and the cloud.
- Interactive or delegated, and you can switch mid-task - Steer a conversation while it runs, or hand it off to a cloud agent and pick it back up locally when it’s done.
- You approve before anything lands - The agent asks before it runs commands, edits files, or calls MCP servers. Set how much it does on its own with Agent Profiles and permissions, and review generated changes in interactive code review.
- Many agents at once - Run several conversations in parallel and track them in the Agent Management Panel, or use orchestration to have a parent agent spawn and coordinate children.
Try this prompt — open in Warp
Detect my current operating system. Based on that, navigate to the appropriate Warp themes directory (e.g. ~/.warp/ on macOS).
Then, clone the official Warp themes repository using SSH (git@github.com:warpdotdev/themes.git) into that directory, following the structure and instructions provided in the repo's README. If SSH does not work, try HTTPS (https://github.com/warpdotdev/themes.git) or via the GitHub CLI (gh repo clone warpdotdev/themes).Third-party CLI agents
Section titled “Third-party CLI agents”Separately from the Warp Agent, Warp gives third-party CLI coding agents first-class support. Run Claude Code, Codex, OpenCode, and others inside Warp and get rich input, agent notifications, inline code review, and remote session control.
→ Learn about third-party CLI agents
Where to go next
Section titled “Where to go next”- Interacting with agents - Conversations, context, code review, and voice in the Warp app.
- Agent capabilities - Planning, skills, rules, MCP servers, task lists, and model choice.
- Warp Agent CLI quickstart - Install the CLI and run your first conversation.
- Cloud agents quickstart - Run your first agent in the cloud, or put one on a schedule. For a comparison of triggers across schedules, Slack, Linear, GitHub Actions, the CLI, and the API, see Run unattended agents.
- Agent FAQs - Models, privacy, credits, and limits.
Open source
Section titled “Open source”Warp’s client is open source under AGPL v3, so the editor and terminal that host your agents are fully auditable. See Contributing to Warp.