Promote (Sandbox)
The action that merges all changes from a sandbox session into your project's default branch. Cannot be undone, so requires confirmation.
What it is
Promote merges the sandbox branch into your project's default branch (typically `main`). Orbit detects the actual default branch, runs the merge in a temporary worktree (never your live project root), and on success appends a session-level COMPLETION_LOG entry citing the merge commit and prompts that landed.
When you would use it
Once you've reviewed the cumulative sandbox diff and verified it works, Promote brings it into your real codebase.
Common operations
- Finalizing a successful sandbox experiment
- Committing accumulated sandbox work to main
Related terms
Where this is taught
No learning path uses this term yet. Browse the Learning Atlas for guided sequences through related ideas.