Agree on the plan once. Then walk away.
Shape the plan with your agent: the steps, the files it may change, and how it will prove the work is done. Hand it off, and KodaCode carries it through on its own while you focus on what’s next.
Every goal runs in its own copy of your project, so your branch and your uncommitted changes stay exactly as you left them.
The agent checks its work against the criteria you agreed. When it’s done, review the result, then merge it as a single commit or discard it.
Come back to finished work, not a list of questions.
The plan lists each step, the files it will touch and how the result will be checked. Tell it what to change as often as you like. Each new version marks the steps that are new or different, so you don't have to reread the whole thing. Accepted plans are saved in your project, under .koda/plans.
An accepted plan runs in a git worktree and starts from your last commit. The goal does not change your checkout or your saved and uncommitted work. You can let it run in the background after you close Koda. You can pause it or cancel it at any time.
When the goal finishes, it waits for you. Merge adds all of its changes to your project as one commit. Discard deletes the goal's work. If you select Merge when done on the plan, the goal merges automatically when it finishes. If its changes conflict with your commits or your uncommitted edits, Koda does not change your project, and the goal tells you why.
| Working | In its own copy, on its own branch |
| Paused | Stopped by you; resume whenever you like |
| Blocked | It needs something from you before it can go on |
| Done | Waiting for you to merge or discard |
| Merged | In the project as one commit |
| Discarded | Its copy and its work are gone; your project never changed |