# Git Worktree > Manage Git worktrees for concurrent local development. Creates worktrees Use when this capability is needed. - Skill: `tomevault-io/git-worktree-3` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/git-worktree-3` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/git-worktree-3/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/git-worktree-3 --- # Git Worktree Manage worktrees for concurrent development without clobbering changes. ## Setup ```bash ~/.claude/skills/git-worktree/scripts/wt.sh install source ~/.zshrc ``` ## Usage ```bash wt # Create worktree, run setup, open editor wt --base ref # Create from a specific base branch (default: main) wt --no-editor # Create without opening editor wt --open # Also open terminal tab with claude session (macOS) wt --carry # Create and copy work-in-progress files wt --context f # Copy file to .context/handoff.md (session fork) wt cd # Change to worktree directory wt home # Return to main repo (or REPOS_ROOT if outside git) wt apply [branch] # Rebase onto branch and merge (default: main) wt apply --archive # Merge and archive without prompting wt apply --push # Merge and push to remote wt archive [branch] # Run archive script, move to ~/.worktrees/.archive wt archive --delete-branch # Also delete local and remote branches wt done # Archive current worktree and cd home (shell function) wt done --delete-branch # Also delete branches on the way out wt clean # Archive merged worktrees (current repo) wt clean --all # Archive merged worktrees (all repos) wt clean --dry-run # List merge candidates without archiving wt clean --delete-branch # Also delete branches when cleaning wt list # List all worktrees wt list --all # Include worktrees from other sources (.claude, .codex, etc.) wt ls # Alias for list wt tree # Tree view with git status indicators wt status # Show worktrees with Claude session activity wt open [branch] # Open editor for worktree (current dir if no branch) wt install # Add wt to ~/.zshrc (one-time setup) ``` ## Worktree Path Convention Worktrees are created at `~/.worktrees//` where `` is the **origin remote name** (not the local directory name). This is derived from `git remote get-url origin`. ``` ~/.claude (remote: dotclaude.git) → ~/.worktrees/dotclaude/ ~/code/services (remote: services.git) → ~/.worktrees/services/ ``` ## Environment ```bash WORKTREES_ROOT=~/.worktrees # Where worktrees are created REPOS_ROOT=~/code # Fallback for `wt home` outside git WT_TERMINAL=ghostty # Terminal for --open (auto-detects from TERM_PROGRAM) ``` ## Example ```bash wt feature-auth # Creates worktree and opens editor # ... work on feature ... wt apply # Merge into main (prompts to archive) ``` Or archive from within the worktree when you're done: ```bash wt feature-auth # Creates worktree and opens editor # ... work on feature ... wt done # Archive and cd home in one step wt done --delete-branch # Same, but also delete the branch ``` ## Carrying Work in Progress When you've been exploring and decide it should be its own branch: ```bash # You're in main with untracked files and modifications... wt feature-x --carry # Creates worktree with those files copied over ``` Copies untracked files to the new worktree. Works from any branch. ## conductor.json (Optional) If your repo has a `conductor.json`, scripts run automatically: ```json { "scripts": { "setup": "cp $CONDUCTOR_ROOT_PATH/.env .env && bun install", "archive": "git stash" } } ``` ## For Claude Code When user asks to create a worktree, run: ```bash wt ``` The script handles branch detection, env file copying, and setup automatically. Suggest opening the worktree in their editor after creation. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/fairchild) — claim your Tome and manage your conversions.