Skip to content

Run a multi-step task

When a task creates a todo list, follow its progress in Kora and use the available controls to stop the active turn, retry a failed step, or skip a failed or pending step.

Mode What Kora does Confirmation and edits
Ask Runs step by step and shows its reasoning Confirms destructive actions; edits require review
Plan Prepares a plan and waits for your approval An approved plan continues in Build mode
Debug Runs autonomously with reasoning and context retrieval visible No per-action confirmation; edits are applied automatically
Build Runs autonomously with minimal intermediate output No per-action confirmation; edits are applied automatically

Each turn has a limit of 128 tool-call steps. Ask, Plan, and Debug can continue automatically up to 5 times; Build up to 10 times. When the limit is exhausted, start a new turn to continue.

  • Ask / Plan — reasoning visible, tool calls minimal, context retrieval hidden (Ask) or shown (Plan).
  • Debug — reasoning and context retrieval shown, plus RCA (root-cause analysis) up front; tool calls stay minimal.
  • Build — silent execution; tool calls minimal.

While a multi-step task is running:

  • Press Esc twice to stop the active turn.
  • Send another message while Kora is working to add it to the queue.
  • Use Retry on a failed workflow step.
  • Use Skip on a failed or pending workflow step.
  • Use Approve on a completed decision step.

Workflow state survives app restarts and session refreshes. Close Kora, come back, and the workflow is still there — pick up exactly where you left off.

  • Workflow stops unexpectedly → the per-mode step limit or the auto-continue cap was reached. Start a new turn to continue.
  • Retry doesn’t appear → the action is available only on a failed workflow step.
  • Todos persist after session close → by design. Use the Clear button in the Todo panel to dismiss them manually.
  • Plan never executes → select Approve & switch to Build in the plan panel; rejecting the plan returns it for revision.

See also: Todo panel for tracking task progress visually.