Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.joggr.ai/llms.txt

Use this file to discover all available pages before exploring further.

Create a local sandbox with jog sandbox create, do your work in isolation, then clean it up when you’re done.

​
Prerequisites

Complete Setup Sandboxes before continuing.

​
1. Create a sandbox

jog sandbox create feat/my-feature
If you omit the branch name, the CLI prompts you for one. Joggr creates a git worktree at ~/.joggr/worktrees/{owner}/{repo}/feat-my-feature, copies any configured files, runs your setup commands, and drops you into an isolated session on that branch. Branch names are normalized (slashes become dashes) for cross-platform and cross-agent compatibility.

​
2. Work in isolation

You’re now in a full checkout of the repo on your new branch. Your main working directory is untouched. 
git status   # shows feat/my-feature
git log      # shared history from your main repo
Run commands, write code, start your dev server — everything is scoped to this sandbox.

​
3. Detach sandbox

When you’re done for now, detach without stopping the session: 
Ctrl+O d
You’re back in your main shell. The sandbox keeps running in the background.

​
4. Re-attach sandbox

Come back to your sandbox anytime: 
jog sandbox attach feat/my-feature
Or open the dashboard to pick from all sandboxes: 
jog sandbox

​
5. Remove sandbox

When the work is done and merged: 
jog sandbox remove feat/my-feature
The CLI confirms before deleting. The worktree and session are cleaned up. If the sandbox has uncommitted changes, removal is blocked — use --force to override.