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?
- Open the Agent panel: Mac: Press CmdCtrl + I Windows/Linux: Press Ctrl + I
- Press Shift + Tab from the chat input to cycle through modes until you reach Plan.
- Type your request
- Press ReturnEnter. Agent explores your codebase and may ask clarifying questions.
- Review the plan Agent creates. It opens as a virtual file you can read and edit.
- 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:
- Find the Revert button in the bottom right of a previous chat message
- Click Revert, then press Confirm to roll back your files to that stage
- 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.