/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.

✅ 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