Command reference Β· Cursor CLI
/plan
Switches to Plan mode, where the agent drafts a plan before acting.
/plan switches to Plan mode, shows the current plan, or submits a prompt directly in Plan mode. Plan mode has a persistent plan menu with 'Build Locally' and 'Build in Cloud' options; plans are saved to disk and can be transferred to cloud agents.
π¬ AS A SHORT VIDEO
Switches to Plan mode, where the agent drafts a plan before acting.
π THE SAME TASK (βPLAN MODE (PLAN FIRST, THEN ACT)β) ON OTHER PLATFORMS
- Claude Code: /plan
- Codex CLI: /plan
- Aider: /architect
- Antigravity CLI: Shift+Tab Β· /plan
β WHEN TO USE IT?
Nail down the strategy before a bigger rework
/plan Migrate the auth system to OAuth2 β review the plan before touching code
Structure a multi-step task before the agent starts
/plan β view and adjust the current plan before picking 'Build Locally'
β WHEN NOT TO?
Just a short, unambiguous single change
For a simple one-line change, going through a plan first is unnecessary.
Better: Prompt directly in the normal agent mode
You just want to read and understand, not plan
/plan targets execution planning, not pure research without intent to implement.
Better: Use /ask for read-only questions
SOURCES
- Cursor Docs β Slash Commands β cursor.com
MORE COMMANDS Β· Cursor CLI