Sandbox session
A specific instance of a sandbox in Orbit. Each session has its own branch, its own worktree, and its own collection of prompts.
What it is
A sandbox session is created when you start sandbox work — Orbit creates a `sandbox/<name>` branch and a worktree. You queue prompts to that session; they run on the session's branch. When done, the session is either Promoted (merged to main) or Discarded (cleaned up). Multiple sandbox sessions can exist for one project.
When you would use it
You start a sandbox session whenever you want isolated experimental work in a project.
Common operations
- Creating a new sandbox session for an experimental task
- Queueing prompts to an active session
- Reviewing cumulative changes before promote
Related terms
Where this is taught
No learning path uses this term yet. Browse the Learning Atlas for guided sequences through related ideas.