- 01
Plan
It searches the repo, reads the files that matter and writes a plan. Code edits are blocked in this mode; commands still ask first.
- 02
Build
Press Build and it works through the plan's todos, edits files and runs your tests, showing each step as it goes.
- 03
Review
Review mode reads and reports. It can't edit files or run shell commands, so it's safe to point at anything.
The details
- Plan mode blocks edits to your project; the only file it writes is the plan.
- Review mode blocks edits, writes and shell commands.
- Plan and Review can hand research to helper agents, but not to the one that writes code.
- Type a note while it runs. It's queued into the same session, so the agent picks it up without starting over.
- If a Build task turns out bigger than it looked, it steps back to Plan so you can agree on the approach.
Questions
Can the agent change my code in Plan mode?
No. Plan mode denies edits and writes to your project. The only file it can write is the plan itself. Shell commands still need your approval.
Can I change direction while it's working?
Yes. Type a note at any time. It goes into the running session, and the agent reads it and adjusts without a restart.
What does Review mode do?
It reads code and reports what it finds. Edits, file writes and shell commands are denied, so it can look at anything without changing it.