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-aware behavior
Section titled “Mode-aware behavior”| 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.
Visibility per mode
Section titled “Visibility per mode”- 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.
Control the task
Section titled “Control the task”While a multi-step task is running:
- Press
Esctwice 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.
Persistence
Section titled “Persistence”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.
Troubleshooting
Section titled “Troubleshooting”- 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.