Worktree Commands

Git worktrees allow parallel development on multiple branches simultaneously.

Worktree Location

Worktrees are created in a standardized location relative to your main repository:

<repo-parent>/<repo-name>-worktrees/<feature>/

Example:

If your main repository is at /Users/you/projects/myapp, worktrees will be created at:

/Users/you/projects/myapp-worktrees/feature-auth/
/Users/you/projects/myapp-worktrees/bugfix-123/
/Users/you/projects/myapp-worktrees/experiment/

This structure keeps worktrees organized and separate from your main repository while maintaining a predictable location.

scc worktree

List worktrees for the current repository (default).

scc worktree

Supports the same options as scc worktree list (e.g., -i, -v).

scc worktree create

Create a new worktree for parallel development.

scc worktree create <WORKSPACE> <NAME> [OPTIONS]

Arguments:

Argument	Description
`WORKSPACE`	Path to the main repository
`NAME`	Name for the worktree/feature

Options:

Option	Description
`-b`, `--base BRANCH`	Base branch (default: current)
`--start` / `--no-start`	Start Claude after creating (default: `--start`)
`--install-deps`	Install dependencies after creating

Examples:

# Create worktree and start session
scc worktree create ~/project feature-auth

# Create from specific branch
scc worktree create ~/project bugfix-123 --base main

# Create without starting Claude
scc worktree create ~/project experiment --no-start

scc worktree list

List all worktrees for a repository.

scc worktree list [WORKSPACE] [OPTIONS]

Options:

Option	Description
`-i`, `--interactive`	Select a worktree to work with
`-v`, `--verbose`	Show git status
`--json`	Output as JSON
`--pretty`	Pretty-print JSON output

Verbose status indicators:

Symbol	Meaning
`+N`	N staged files
`!N`	N modified files
`?N`	N untracked files
`.`	Clean worktree
`…`	Status timed out

Examples:

# List worktrees
scc worktree list

# List with git status
scc worktree list -v

# Interactive picker
scc worktree list -i

scc worktree enter

Enter a worktree in a new subshell.

scc worktree enter [TARGET] [OPTIONS]

Arguments:

Argument	Description
`TARGET`	Worktree name, `-` (previous), `^` (main), or fuzzy match

Options:

Option	Description
`-w`, `--workspace PATH`	Repository path (default: current)

Examples:

# Enter by name
scc worktree enter feature-auth

# Enter main branch worktree
scc worktree enter ^

# Enter previous worktree
scc worktree enter -

# Type 'exit' to return

scc worktree switch

Switch to a worktree (outputs path for shell wrapper).

scc worktree switch [TARGET] [OPTIONS]

Arguments:

Argument	Description
`TARGET`	Worktree name, `-` (previous), `^` (main), or fuzzy match

Options:

Option	Description
`-w`, `--workspace PATH`	Repository path (default: current)

Shell wrapper (add to ~/.bashrc or ~/.zshrc):

wt() {
  local p
  p="$(scc worktree switch "$@")" || return $?
  cd "$p" || return 1
}

Then use:

wt feature-auth  # Switch to feature-auth
wt -             # Switch to previous
wt ^             # Switch to main

scc worktree select

Interactive worktree picker.

scc worktree select [WORKSPACE] [OPTIONS]

Options:

Option	Description
`-b`, `--branches`	Include branches without worktrees

scc worktree remove

Remove a worktree.

scc worktree remove <WORKSPACE> <NAME> [OPTIONS]

Arguments:

Argument	Description
`WORKSPACE`	Path to the main repository
`NAME`	Name of the worktree to remove

Options:

Option	Description
`-f`, `--force`	Force removal with uncommitted changes
`-y`, `--yes`	Skip confirmation
`--dry-run`	Preview what would be removed

scc worktree prune

Clean stale worktree entries from git.

scc worktree prune [WORKSPACE] [OPTIONS]

Options:

Option	Description
`-n`, `--dry-run`	Preview what would be pruned

Examples:

# Preview what would be pruned
scc worktree prune -n

# Actually prune stale entries
scc worktree prune