Park and resume

Set a feature aside without losing it: close its terminals, keep the worktree and branch on disk, and reopen it days later exactly where the code was.

Park it

Make sure the agent isn't mid-turn, then close the worktree's terminals:

beswarm agent list
beswarm worktree close --name feat-export --workspace app

close kills the shells and the agent in them, but the worktree and its branch stay on disk. Uncommitted changes stay too, since they're just files in the checkout.

note

Ask the agent to commit work-in-progress, or write a short NOTES.md on where it stopped, before you park. A fresh agent next week starts with no memory of this one.

See what's parked

beswarm worktree list --workspace app

A parked worktree shows 0 open terminals.

Resume it

In the sidebar, right-click the workspace and choose Open worktree, then pick it. A terminal opens in the checkout.

Start a new agent there and point it at the notes:

beswarm status   # find the terminal id
beswarm agent start --name export --agent claude <terminal-id> \
  --prompt "Read NOTES.md and git log on this branch, then continue the CSV export feature."

If your agent can resume its last conversation in that folder, pass its native flag after -- instead. For Claude Code:

beswarm agent start --name export --agent claude <terminal-id> -- --continue

Retire it

Once it's merged, or abandoned:

beswarm worktree remove --name feat-export --workspace app

remove keeps a branch with unmerged commits, so abandoned work isn't lost by accident.