# Planning

Warp has native planning functionality that helps you break down complex engineering tasks into structured, executable steps. Planning is tightly integrated with Warp's coding agent and provides a persistent plan editor, version history, selective execution, and deep links into your workspace.

{% embed url="<https://youtu.be/DawcFWyudV0?si=OzvuInMl8DoNR97R>" %}

***

### Creating a plan

You can generate a plan using the `/plan` [slash command](https://docs.warp.dev/agent-platform/capabilities/slash-commands) or by asking the agent in natural language.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-2dac8a2b54cc62baa10c5e14e0641af2c9303b52%2Fplan-slash-command.png?alt=media" alt="" width="375"><figcaption><p>Prompting the agent to create a plan using the slash command.</p></figcaption></figure>

The agent then creates a structured plan inside Warp’s native rich text editor, which is designed for long, multi-step workflows. The editor includes clean formatting, inline code blocks, and clickable file paths so you can open referenced files immediately in Warp (see below) or in your external editor.

### Reviewing and editing

Once a plan is generated, you can review it, reorganize steps, or refine details. You can edit the document manually or ask the agent to revise sections for you.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-2b9f06a850d55a7cd8369a0e33598ffa3a6a1b37%2Fplanning-main-view.png?alt=media" alt=""><figcaption><p>Plan editor in Warp.</p></figcaption></figure>

Any update made by the agent **creates a new version**. Version history lets you compare past iterations and restore an older version if you want to revert your approach, preserving a clear decision trail as the plan evolves.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-cf42bf2139bd75660e39a2ca87dc0aa888a472b3%2Fagent-plans-versioning.png?alt=media" alt=""><figcaption><p>Access previous versions of your plan.</p></figcaption></figure>

### Executing a plan

When you’re ready to start implementing, prompt the agent to run the plan. You can ask it to execute the full set of steps or only a specific section, such as “Implement phase 1 of the plan.”

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-6a2f4dc0cc2cccd3e7448b85cb3da532d5d53ed6%2Fmanually-trigger-plan.png?alt=media" alt=""><figcaption><p>Manually referencing the plan using @ to kickoff the plan.</p></figcaption></figure>

The agent applies changes incrementally and updates files as it proceeds. This makes it easy to validate early steps before moving forward, adjust the plan mid-run, or try alternative paths without committing to the full workflow.

If you revise the plan while the agent is running, you can notify it directly; the agent will adjust its execution based on your updates.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-ad09cd96d943dcb0c73a7c15baa1e434ac4b918b%2Fupdate-agent-mid-plan.png?alt=media" alt="" width="375"><figcaption><p>Option to pass new plan to agent if plan changes during runtime.</p></figcaption></figure>

### Monitoring progress

While the agent is running, you can reopen the plan at any time by selecting **View plan** in the input. You can also follow each change in real time through the [Code Review](https://docs.warp.dev/code/code-review) panel and add comments or guidance using [Interactive Code Review](https://docs.warp.dev/agent-platform/local-agents/interactive-code-review).

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-770f73882335d7a2a40459476bf430c57e2b6ecb%2Fagent-plans-tasks.png?alt=media" alt=""><figcaption><p>Monitoring progress with the task list and plan view.</p></figcaption></figure>

This gives you clear oversight, helps confirm expected behavior, and lets you intervene quickly if something needs correction.

### Saving and sharing

Warp automatically saves all plans in the *Plans* folder in [Warp Drive](https://docs.warp.dev/knowledge-and-collaboration/warp-drive/). You'll see a confirmation when your plan is synced.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-b6a3aa0cb8397debaeca0fc1d465668b0782f9c9%2Fagent-plans-synced.png?alt=media" alt=""><figcaption><p>Plans are automatically synced to Warp Drive.</p></figcaption></figure>

You can export any plan as Markdown, check it into your repository, or share a link—useful for GitHub PRs, design reviews, or async collaboration.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-03cb4b5e7d423b431f583a10bf6ae9aacbf67999%2Fexport-notebooks.png?alt=media" alt="" width="375"><figcaption><p>Different ways to share a plan.</p></figcaption></figure>

Because plans persist in Warp Drive, you can return to them later, reuse them for new work, or treat them as documentation for ongoing projects. This is also naturally passed to the agent as context.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-8d1a407a52d3478147a262f32b6cb02930bc8e60%2Fplans-in-warp-drive-side-panel.png?alt=media" alt=""><figcaption><p>Plans are accessible directly from the Warp Drive side panel.</p></figcaption></figure>

You can configure whether your plans will be automatically added and synced to Warp Drive in your [Agent Profiles & Permissions](https://docs.warp.dev/agent-platform/capabilities/agent-profiles-permissions) under **Settings** > **AI** > **Agents** > **Profiles**.

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-4309952619d934effc5f1ac575a86538abff8334%2Fauto-sync-plans%20(1).png?alt=media" alt="" width="371"><figcaption></figcaption></figure>

### Using plans across conversations

Plans are reusable across tasks and sessions. You can reference them in future prompts, continue where you left off, or build follow-up plans that rely on earlier work.

The **@plans** command helps you quickly search for and reopen previously saved plans, making planning a consistent part of your development workflow rather than a one-off step. Learn more about attaching context using @ [here](https://docs.warp.dev/agent-platform/local-agents/agent-context/using-to-add-context).

<figure><img src="https://769506432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAULCelT4yIUOcSwWWvPk%2Fuploads%2Fgit-blob-bc2e9b17ad413a97c3f265de815c8f9dd0d2996f%2F%40-reference-plans.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
