Stop, pause or retry a run
Pause a run after its current step, resume it, restart it from the beginning or cancel it, without losing its work.
On this page
You stay in control of every run. You can hold it, start it again or stop it, and Duun keeps the worktree and conversation so nothing is lost. All of these actions live in the run’s ⋯ menu at the top right of the run page.
Pause a run
Pausing lets the agent finish what it’s doing, then holds the run before the next step.
- Open the run and select ⋯ in the header.
- Choose Pause after this step. The agent replies “Holding after the current step. Nothing else runs until you say go.”
- Choose Resume run from the same menu when you’re ready. The run continues with the next step.
Pausing is useful when you want to check something before the agent continues, or when a teammate needs to look first.
Cancel a run
- Open the run and select ⋯, then Cancel run….
- Read the confirmation and select Cancel run. The agent stops after its current tool call. Choose Keep running if you changed your mind.
A cancelled run keeps its worktree and thread, so you can restart it later. Any pull request it opened stays open until you close it.
Restart a run
Choose Restart run from the run menu to start it again from the first step, with the same input. Use it after you’ve fixed whatever made the run fail, such as a missing secret or a broken test on the main branch.
Retry only part of a run
You don’t always need to restart everything:
- Checks failed. Select Re-run checks on the Checks tab.
- The plan or code is wrong. Select Request changes and say what to fix. The agent revisits the step instead of starting over.
- Steps with automatic retries. Many workflows send failures back to an earlier step with feedback, for a set number of attempts. You’ll see “attempt 2” on the step.
Hand the run to someone else
Choose Hand to teammate… or Hand to another agent… from the run menu. Add a note about what to look at first. To work on it yourself, choose Take over in terminal.
Stop hearing about a run
Choose Unfollow to stop notifications for a run you don’t need to track, or Notify me on every step to follow it closely.
If something goes wrong
- The run says “Paused · budget”. A spending limit paused it, not a person. See A budget paused my run.
- Pause didn’t take effect right away. The current step has to finish first. Long steps, such as a full test suite, can take a few minutes.
- The agent isn’t responding. See An agent seems stuck.
Developers can do the same from the API with POST /runs/{run_id}/pause and related endpoints; see Runs.