Plan Mode and Auto-Accept Mode
Command Code separates reasoning from execution using permission modes:
- Plan Mode: Explore and plan without executing file changes
- Auto-Accept Mode: Implement changes without confirmation prompts
Shift + Tab is your CLI shortcut to switch between plan and auto-accept modes.
Plan mode helps you with structured thinking. It can:
- Read your codebase
- Search files
- Analyze architecture
- Discuss tradeoffs
- Propose implementation plans
It cannot:
- Modify files
- Run shell commands
- Apply patches
We recommend Plan mode to:
- Explore unfamiliar codebases
- Debug complex issues
- Design multi-file features
- Evaluate architecture decisions
- Identify edge cases early
- Review sensitive or critical flows
Auto-Accept mode is for fast implementation and execution.
- Modifies files directly
- Applies patches without confirmation
- Executes shell commands
- Proceeds step-by-step automatically
We recommend Auto-Accept mode when:
- The approach is already clear
- You are iterating quickly
- You trust the implementation path
Command Code creates Checkpoints before modifying files, so you can rewind at any time.
Default mode sits between the Plan and Auto-Accept modes.
- File edits require confirmation
- Commands require approval
Use the Default mode when you want controlled iteration without fully separating planning and execution.
- Start in Plan Mode
- Explore relevant files
- Discuss approach and edge cases
- Switch to Auto-Accept Mode if you're ready to implement
- Rewind with Checkpoints if needed
| Use Case | Recommended Mode |
|---|---|
| New feature with unclear scope | Plan |
| Debugging complex issue | Plan |
| Multi-file refactor | Plan |
| Security review | Plan |
| Small bug fix | Auto-Accept |
| Routine refactor | Auto-Accept |
| Running tests and adjusting | Auto-Accept |
| Quick typo fix | Auto-Accept |
- Use Plan Mode to outline a change, then switch to Auto-Accept to implement it
- Join our Discord community for support