Delete and Recover a Worktree
Deleting a worktree: what the dialog spells out before you confirm, what force delete costs, what happens to running agents, and the deleted-worktree rescue card that keeps surviving sessions alive.
Deleting a Worktree
Open the delete dialog by right-clicking a card and choosing Delete Worktree, from the three-dot menu, or from the action palette. The main worktree (your repository root) is protected and can't be deleted.
The dialog fetches a fresh git status when it opens and re-checks it immediately before a force delete dispatches. A backgrounded worktree's cached snapshot can be half a minute old, which would let a force delete skip the typed-name gate and discard work an agent wrote while the dialog was sitting open. If that fresh check fails, the dialog fails closed: it treats the tree as dirty and escalates the confirmation tier.
What will happen
Five rows spell out the effect before you confirm. Toggling the options strikes through the rows that no longer apply.
- Worktree directory will be deleted. Always active.
- N terminals will be closed, with (N running an agent) appended when any of them are agents. Struck through when Close all terminals is off or there are no terminals.
- Dev server will be stopped. Active only when the worktree has a dev preview running.
- Uncommitted changes will be lost. Red when force delete is on and the tree is dirty; struck through otherwise.
- Branch
{branch}will be deleted. Active when Delete branch is checked and the branch can be deleted safely.
Below the list: "This cannot be undone.", the worktree's full path in a monospaced block, an advisory banner for a dirty tree, and, when force delete is on and there is something to lose, a Files that will be lost listing drawn from the fresh status read.
Three checkboxes follow. The force-delete label describes what it will actually cost, so it changes with the tree: Force delete (lose uncommitted changes and untracked files), (remove untracked files), or (lose uncommitted changes). Then Close all terminals (checked by default) and Delete branch.
The confirm button
- Delete worktree: the default, safe path.
- Force delete worktree: force is on but the action is still low-risk.
- Force delete '{target}': force is on against a risky target. A typed-name input appears and confirm stays disabled until the name matches.
Progress, failure and abandonment
On confirm the dialog closes and the card takes over: the recipe row becomes a Deleting… spinner, the card dims and stops accepting clicks, and it stays mounted until the delete finishes. A failure shows an inline banner titled Couldn't delete worktree with the error text and Retry and Dismiss buttons. The banner sits outside the collapsible details, so collapsing the card doesn't hide it.
Abandoning a delete restores the worktree's terminals rather than leaving them stranded.
The card menu grows a separate Force Delete entry when a worktree has running processes, an in-flight teardown, or a previous deletion that timed out. It opens the same dialog with force pre-checked and a shorter teardown timeout.
To delete several worktrees at once, see Worktrees Overview.
Deleted Worktrees
Deleting a worktree does not have to kill the agents running in it. Close all terminals is checked by default in the delete dialog; uncheck it and the directory goes while the terminals keep running, with the row surviving in the sidebar as a deleted-worktree card, a rescue surface with a visible countdown.
The card deliberately shares the live card's design: same header scale, the same terminal section with its collapsed "N active" bar and expandable rows, and the same select-on-click behavior, so activating it shows its surviving terminals in the grid and dock. What marks it as deleted is a FolderX icon, a Deleted pill, the struck-through path and a slight fade that lifts on hover and focus.
Rescuing a session means dragging its terminal out onto a live worktree, or using Move to worktree from the terminal's menu. A deleted row never accepts a terminal dropped onto it: it is excluded from the drop-target machinery by construction, not by a flag.
The row anchors itself to the live neighbor it sat above when it was deleted, so the terminals you are looking for stay roughly where you left them instead of jumping to the end of the list. Once two or more pile up they collapse into a single group row with one bulk clear and a rail carrying every surviving terminal, each still draggable.
The countdown
Leftover terminals move to trash when the timer ends, after which the row prunes itself. Deleted rows are deliberately ephemeral and never survive a restart.
The countdown measures time you could actually have seen it, not wall time. It refuses to run while the project's view is cached or the window is hidden, and credits any gap it finds on the way back. It also holds (pinned at whatever remained, not reset) while firing would break something:
| Hold | Label | Why |
|---|---|---|
| A drag is in progress | Dragging | Dragging a terminal out is the rescue gesture; expiring mid-drag would yank the source away. |
| The row's close confirmation is open | Confirming | You are mid-decision. |
| A surviving agent is still working | Agent working | Active output resets the idle clock. |
Every hold is capped, so a condition that never clears can't pin a row open forever: five minutes for a drag or a confirmation, an hour for a working agent. The row says which condition is holding it, then the preserved countdown resumes.
Set the timer in Settings > Worktree > Deleted worktrees: 30 seconds, 1 minute (default), 5 minutes, or Never (close manually).