Cmd. /plan
Switch to plan mode and optionally send a planning prompt.
Key takeaways
/planswitches the active conversation into plan mode, and you can include inline text as the first planning request.- Use it for migration planning or risk review before destructive or broad edits, breaking vague requests into execution steps.
- Unlike
/goal, which persists a long-running objective,/planreasons through scope;/sideis for a short separate detour. /planis temporarily unavailable while a task is already running, and planning is not verification, so still run tests after implementation.
Original Command Declaration
/planOfficial Summary
/plan switches the active conversation into plan mode. You can include inline text as the first
planning request.
Usage
/planGood Examples
- Use
/plan Propose a migration plan for this packagebefore editing a risky module. - Use
/planafter/statuswhen you need Codex to reason through scope before implementation.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/plan | Enters planning mode | You need a plan before edits |
/goal | Persists a long-running objective | The task will continue across turns or sessions |
/side | Starts a focused detour | You need a short separate risk check |
Use Cases
- Migration planning.
- Risk review before destructive or broad edits.
- Breaking vague requests into execution steps.
Cautions
/planis temporarily unavailable while a task is already running.- Planning is not verification; still run tests or reviews after implementation.
Release Basis
- Judgment: confirmed addition
- First evidence version:
rust-v0.93.0 - Date (UTC): 2026-01-31
- Release link: https://github.com/openai/codex/releases/tag/rust-v0.93.0
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex CLI features: https://developers.openai.com/codex/cli/features