Worktree

input = $ARGUMENTS

Branch Name

Derive from input; ask if missing. Default: /, conventional commit types (feat when ambiguous). Check git branch first — if repo uses different convention (e.g., feature/JIRA-123-desc), match it.

Show derived name before proceeding.

Worktree Location

• {repo_root}/.claude/worktrees/{branch_slug} where branch_slug replaces / with -
• repo_root = git rev-parse --show-toplevel
• Ensure .claude/worktrees/ exists and is in .gitignore

Base Branch

Branch from latest remote default, not HEAD — HEAD can be stale or on an unrelated branch, silently seeding the worktree with wrong history.

Detect default: git symbolic-ref refs/remotes/origin/HEAD | sed 's|refs/remotes/origin/||' (fallback: try main, then master). Fetch: git fetch origin {default_branch}. Create: git worktree add -b {branch} {directory} origin/{default_branch}.

Branch already exists → git worktree add {directory} {branch} (no -b).

After creation, symlink gitignored files so worktree runs without reinstall:

bash ~/.claude/skills/worktree/scripts/symlink-gitignored.sh {repo_root} {directory}

Output

Show: worktree path, claude --cwd {directory} command, reminder to use /worktree-clean when done, and git worktree list.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: JHostalek
• Source: JHostalek/dotclaude
• License: CC0-1.0
• Homepage: https://jhostalek.github.io/dotclaude/

Install and usage instructions live in the source repository linked above.