# Plan mode

Plan mode lets you generate and review a detailed plan before Agent writes any code. Use it for complex features where you want to approve the approach first.

## How do I use Plan mode?

1. Open the Agent panel:
   - **Mac**: Press Cmd + I
   - **Windows/Linux**: Press Ctrl + I
2. Press Shift + Tab from the chat input to cycle through modes until you reach **Plan**.
3. Type your request
4. Press Return. Agent explores your codebase and may ask clarifying questions.
5. Review the plan Agent creates. It opens as a virtual file you can read and edit.
6. When you're happy with the plan, click **Build** to start coding.

## How do I save plans?

Plans are saved by default in your home directory. Click **Save to workspace** to move it to your workspace for future reference, team sharing, and documentation.

## When should I use Plan mode?

Plan mode works best for:

- Complex features with multiple valid approaches
- Tasks touching many files or systems
- Unclear requirements where you want to explore first
- Architectural decisions where you want to review the approach

For quick changes or tasks you've done many times, stay in Agent mode.

## How do I start over in Plan mode?

If Agent builds something that doesn't match what you wanted, you can roll back to any earlier point in the conversation:

1. Find the **Revert** button in the bottom right of a previous chat message
2. Click **Revert**, then press **Confirm** to roll back your files to that stage
3. Refine your plan to be more specific, then run it again

Spend extra time making the plan precise for larger changes. The hard part is figuring out what to build. With clear instructions, Agent handles the rest.

## Related

- [Agent mode](https://cursor.com/help/ai-features/agent.md)
- [Agent reference](https://cursor.com/docs/agent/overview.md)


---

## Sitemap

[Overview of all docs pages](/llms.txt)