Cmd. /plan
Switch to plan mode and optionally send a planning prompt.
Key takeaways
- Switch to plan mode and optionally send a planning prompt.
- Check the input surface and availability before using the examples below.
Purpose
Switch to plan mode and optionally send a planning prompt.
/planAvailability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Current reference |
| Aliases | — |
| Documented minimum | Not specified |
| Reviewed against | 2026-09-22 · Codex CLI 0.155.1 |
The installed command menu and account or organization settings determine availability.
Examples
/planWhen to use it
- 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.
Choosing related 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 |
Effects and persistence
Switches to a planning workflow. Review the plan and scope before implementation starts.
/plan switches the active conversation into plan mode. You can include inline text as the first
planning request.
Cautions
/planis temporarily unavailable while a task is already running.- Planning is not verification; still run tests or reviews after implementation.
Official sources
Complete command list · Verification scope · History for this command