Skip to content

Running items

Build on an item runs its plan.

The Build button on a todo item in the backlog listThe Build button on a todo item in the backlog list
The Build button on a todo item in the backlog list

Each phase gets a fresh agent session, nested under the item’s card in the sidebar, which works through the phase’s tasks, verifies its work and moves on to the next phase. An interrupted run picks up from the phase it was on.

The run’s card in the sidebar shows running while the agent works, check when it wants you to try a manual check, question when it asks a question, and waiting when it needs you otherwise. ⌘Ctrl. jumps to the next session waiting on you, so you can run several items at once and only step in when one asks.

The Continue toggle on a backlog run's top barThe Continue toggle on a backlog run's top bar
The Continue toggle on a backlog run's top bar
  • Continue on the session’s top bar decides whether the next phase starts on its own. Turn it off to stop after the current phase, then Build again when you’re ready.
  • When a phase has manual checks, the agent asks you to try each one.
  • To send the item back to an earlier phase, Rewind that phase on the item’s plan.
Done on a backlog run in its review phaseDone on a backlog run in its review phase
Done on a backlog run in its review phase

Every run ends with a review phase, added automatically after the item’s own phases. Its session checks the work against each acceptance criterion and fixes what fails. Tell it the item is done once you’re happy, or use Done on the session’s top bar; the item is then marked done.

With the experimental backlog.parallelPhases on, a run starts the phases that don’t depend on each other at the same time, each in its own worktree and session. backlog.maxParallelPhases caps how many run at once (3 by default):

Terminal window
assist config set backlog.parallelPhases true
assist config set backlog.maxParallelPhases 2