> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Agents in Warp

Work with the Warp Agent in the Warp app. Control its autonomy with profiles and permissions, and give it context from your codebase and tools.

This page covers the Warp Agent in the Warp app. You can run the same agent from any terminal with the [Warp Agent CLI](/agents/cli/), or in the background as a [cloud agent](/platform/) on [Oz](/platform/overview/). Warp also supports [third-party CLI agents](/agents/cli-agents/overview/) like Claude Code and Codex.

![Agent Mode Overview](https://i.ytimg.com/vi/qiQtD1jPF6s/sddefault.jpg)

The **Warp Agent** helps you build, test, deploy, and debug while keeping you in control. Describe what you want to do in natural language (*you can even use your voice*), and it takes action using your environment, codebase, and saved context.

## What agents can do

Agents understand your codebase and can execute tasks autonomously while keeping you in control:

-   **Write and edit code** - Create new files, refactor existing code, or make changes across multiple files in your codebase
-   **Debug and fix errors** - Analyze stack traces, interpret error output, and apply fixes
-   **Run commands** - Execute shell commands and use the output to guide next steps
-   **Recover from errors** - Automatically retry failed operations with adjustments
-   **Learn tools** - Integrate with any CLI tool by reading its `--help` or public documentation
-   **Use your context** - Leverage [Warp Drive](/knowledge-and-collaboration/warp-drive/), [MCP servers](/agents/capabilities/mcp/), [Rules](/agents/capabilities/rules/), and [codebase indexing](/agents/capabilities/codebase-context/) for tailored responses

**Try this prompt** — [*open in Warp*](https://app.warp.dev/drive/prompt/Clone-and-install-Warps-themes-repository-PkK9Zw16SCD3JKzOUoGuj4)

```
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).
```

* * *

## Agent autonomy

Under **Settings** > **Agents** > **Profiles** > **Permissions**, you can control how much autonomy the agent has when performing different types of actions:

-   Reading files
-   Creating plans
-   Executing commands
-   Calling MCP servers

For each action, set the autonomy level to:

-   **Let the agent decide** - The agent chooses when to ask for confirmation
-   **Always prompt for confirmation** - Require approval before each action
-   **Always allow** - Execute without prompting
-   **Never** - Disable this action entirely

You can also configure an **allowlist** and **denylist** for specific commands you always want to run—either with or without confirmation.

Note

Warp’s AI features can be globally disabled in **Settings** > **Agents** > **Warp Agent** with the AI toggle.  
  
These features send input data to various LLM providers through their API. Warp is **SOC 2 compliant** and has **Zero Data Retention** policies with all contracted LLM providers. No customer AI data is retained, stored, or used for training. Read more about data privacy for Warp features [on our privacy page](https://www.warp.dev/privacy).

* * *

## Agent profiles

Profiles let you define different permission and model configurations for different contexts. Create and manage profiles in **Settings** > **Agents** > **Warp Agent**, then switch between them by clicking the profile icon in Warp’s input area.

Common profile patterns:

-   **Default** - Balanced permissions for everyday use
-   **YOLO mode** - Loose permissions for personal projects where you want the agent to move fast
-   **Prod mode** - Restrictive permissions (“Always Ask”) for high-risk environments like production servers

For more details, see [Agent Profiles & Permissions](/agents/capabilities/agent-profiles-permissions/).

* * *

## Managing agents

You can run multiple agents simultaneously in Warp. All active agents—both local conversations and cloud agent runs—are tracked in the [management view](/platform/managing-cloud-agents/).

Agents notify you when they need input, such as permission to run a command or approval to apply a code diff. This lets you focus on other work, knowing you’ll be alerted when your attention is required.

To access conversations across devices, share them with teammates, or restore past conversations, enable [cloud-synced conversations](/agents/local-agents/cloud-conversations/).

* * *

## Context and knowledge

Agents work best when they understand your codebase and workflows. Warp provides several ways to give agents the context they need:

-   [**Codebase Context**](/agents/capabilities/codebase-context/) - Warp indexes your Git-tracked files so agents can search and understand your code
-   [**Rules**](/agents/capabilities/rules/) - Define global and project-level guidelines that shape agent behavior
-   [**Skills**](/agents/capabilities/skills/) - Reusable instructions that teach agents how to perform specific tasks
-   [**MCP Servers**](/agents/capabilities/mcp/) - Connect external tools and data sources (GitHub, Linear, databases) to your agents
-   [**Warp Drive**](/knowledge-and-collaboration/warp-drive/) - Save prompts, workflows, and notebooks that agents can reference

* * *

## Next steps

-   [**Using the Warp Agent**](/agents/local-agents/overview/) - Every agent feature available in the Warp app, from code review to voice.
-   [**Agent capabilities**](/agents/capabilities/) - Planning, skills, rules, MCP servers, task lists, and model choice.
-   [**Running agents on a schedule**](/platform/triggers/scheduled-agents/) - Hand recurring work to a cloud agent. 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/) - Common questions about models, privacy, and limits.