When a Team Run Ends

  • Desktop app
  • All plans

What it does

A finished or cancelled team run keeps its box in the agent list until someone closes it. For teams that run all day, those boxes bury the runs that are still working. When a run ends makes them leave the list by themselves, and Clear ended runs removes them in one click.

Where to find it

  • For one team: Teams window > Team settings > When a run ends.
  • For a whole project: Project settings > Capabilities > When a run ends.
  • One click: Clear ended runs (N), under the run boxes of the agent list. It appears when at least one run is over with no console open, and is hidden while the list is filtered.
  • Archived runs: Teams window > the team's History, and the run history on the phone.

How to use it

  1. Open the team's settings, or Project settings > Capabilities for every team of the project.
  2. Under When a run ends, choose Close or Archive.
  3. Let a run finish or cancel it: its box leaves the list within about a minute.

To tidy up once without changing anything, click Clear ended runs (N) under the run boxes.

To see what a step did once its console is gone, click its row in the run box. Its conversation reopens in a new console, without sending anything to the agent. Read it, or write to it to carry on: it is a real CLI and it can then change code. Closing that console removes it, and clicking the step again brings it back. Talk to this role again is different: it restarts the step.

Settings

  • runEndAction (team field; default Use the project default): keep, close or archive. Agents set it with teams_save.
  • teamRunEndAction (project default; default Keep its box in the list, so nothing changes unless you choose): same choices, for the teams that did not pick one. Agents set it with settings_set at project scope.

Keep leaves the box until you close it. Close works like the ✕ of the box: the run and its history are erased. Archive takes the box off the list and keeps the run in the team's history; the 200 most recent archived runs per project are kept.

The choice applies within about a minute of the end, and at the next launch for a run that ended while the app was closed.

Agent tools (MCP)

  • teams_save: sets runEndAction (keep, close, archive, or project for the project default).
  • settings_set: sets teamRunEndAction at project scope.

Providers

All providers, no difference.

Mobile

The phone lists only live runs as cards, so there is nothing to clear there. Ended runs, archived ones included, stay in its run history. The setting is edited on the desktop. Tapping a step without a console reopens its conversation, on the paired computer and from the Remote view for your other machines.

Limits

Applied by the desktop app, on the machine that holds the runs: nothing happens while it is closed. The 200 most recent archived runs per project are kept, older ones are erased. On all three desktop systems.

Reopening a step's conversation works for runs that ended since this feature arrived (November 2026): an older run kept nothing to reopen. It is not offered when the CLI cannot resume, or when the run was too short for its conversation to be noted. It fails with a clear message when the run's working copy was removed. A run erased by Close or by the ✕ has no box left to click: use Archive to keep it in the history.

Common questions

  • Can I see a step's console after the run has ended? Yes: click the step in the run box, on the desktop or the phone. Its conversation reopens in a new console, and nothing is sent to the agent until you write to it. The consoles themselves still close when the run ends, so finished runs keep no CLI running.

  • Can finished and cancelled team runs leave the sidebar by themselves? Yes: set When a run ends to Close or Archive, on the team or as a project default.

  • Does Clear ended runs delete anything? No. It archives, whatever the setting says: the runs stay in each team's history.

  • Why does a run still show after it ended? A blocked run always stays, so it can be resumed. A run with a console still open also stays, until that console is closed. The run of a run-once team stays until the team has deleted itself.

  • I reopened an archived run. Where is it? Back in the list: a reopened run shows its box again.