Run a Prompt in a Sandbox
Use a sandbox when a prompt is risky enough that you don’t want it touching your main branch until you’ve seen the result.
- In the New Prompt modal, set Run In: Sandbox instead of Live.
- Queue and approve the prompt as usual. It runs in an isolated git worktree.
- When it finishes, open the Sandbox Sessions panel and review:
- View Cumulative Diff to see everything the session changed.
- Decide:
- Promote — merges into your default branch through a throwaway temp worktree.
- Discard — throws the session away.
If a session freezes
Section titled “If a session freezes”Any of these gets you out: the titlebar exit button, the banner action, Ctrl+Shift+X, or the automatic exit after three failed starts.
Cleaning up
Section titled “Cleaning up”Orphaned worktrees, branches, and session rows are detected in the background. Clear them under Settings → Queue & Sessions → Sandbox with per-item Clean Up or Ignore.