Goals
An accepted plan runs in its own copy of the project, within a budget, and lands as one commit when you merge it.
A goal is a plan that you accepted. It runs on its own while you work on something else.
Start a goal
- Ask for the work in Plan mode. The agent proposes a plan: each step, the files it will touch, and how it will check the result.
- Ask for a revision as often as you like. Each version marks what is new or different.
- Accept plan with a Goal budget in dollars. The field starts from Default goal budget ($5.00). Leave it empty for no limit. Tick Merge when done to merge as soon as the goal finishes.
KodaCode saves accepted plans in .koda/plans/.
Its own copy
The goal runs in a separate copy of the project under .koda/worktrees/, on its own branch. It does not touch your checkout, your editor or your uncommitted work. If the project runs in a container, the goal gets its own container. Open it from the terminal panel as Goal container.
The goal bar
A bar above the session shows where the goal stands and what it has spent:
| State | Meaning |
|---|---|
| Working in its own copy | Running. Pause stops it. Resume continues it. |
| Out of budget | It spent its budget. New budget or Raise and resume. |
| Its plan is waiting for you | A plan needs your verdict. |
| Plan accepted, running as a goal | It started. |
| Done, waiting for you to merge or discard | Finished. |
Merge adds all of its changes to your project as a single commit. Discard deletes the copy and its work. Something can block a merge, such as a conflict or a commit that you made meanwhile. Then your project stays exactly as it was, and the goal says what happened. A goal that polls a running command cannot merge or be discarded until the command ends.
Close hides the bar. It deletes nothing.
Autonomous tasks
Autonomous tasks (/autonomous, ⇧⌘B) lists the goals, automations and MCP tasks that work on their own, for you to review. Search by title, project or branch. For each one, choose Review and merge, Raise budget, Resume, Open session, Discard or Keep. Copies on disk shows the copies they hold.
- Parallel autonomous tasks, how many run at the same time per project (4)
- the default goal budget
- a reminder when finished tasks wait for you
The agent can read the progress of goals with its goal_status tool. A goal reports its end with update_goal: complete, or blocked with what it needs.