KodaCode
Coming soon
Docs/Working with the agent

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

  1. In plan mode the agent explores the project read-only and writes a plan: the context, its assumptions, and the steps with their detail.
  2. It gives you the plan in a Plan proposed card and waits.
  3. You choose:
ChoiceWhat happens
Accept planThe plan runs. With a goal budget it runs as a goal in its own copy of the project.
Merge when doneMerge the goal's work as soon as it finishes, without waiting for you.
Goal budget in dollarsThe most the goal may spend. Its default comes from Default goal budget ($5.00).
Ask for a revisionSay what to change. The agent revises the plan.
Reject planKodaCode 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/.