Plan mode
Design a change read-only first, then accept it, revise it, or run it as a goal.
Build makes changes. Plan designs them first, read-only. Switch with the Build / Plan toggle in the top bar or ⇧⌘P. The agent can also switch itself into plan mode when a task deserves a design first.
How a plan works
- In plan mode the agent explores the project read-only and writes a plan: the context, its assumptions, and the steps with their detail.
- It gives you the plan in a Plan proposed card and waits.
- You choose:
| Choice | What happens |
|---|---|
| Accept plan | The plan runs. With a goal budget it runs as a goal in its own copy of the project. |
| Merge when done | Merge the goal's work as soon as it finishes, without waiting for you. |
| Goal budget in dollars | The most the goal may spend. Its default comes from Default goal budget ($5.00). |
| Ask for a revision | Say what to change. The agent revises the plan. |
| Reject plan | KodaCode writes nothing. |
While a plan runs, the agent reports progress against its steps (in progress, done, dropped).
If a turn ends in plan mode without an accepted plan, the transcript says: "Ended while planning: no plan was accepted, so nothing was written."
KodaCode saves plans in .koda/plans/.