A simple worktree management utility with fzf-powered navigation.

Starting a new feature:

Reviewing a remote branch:

fzf is only a shorthand: wt ls / wt rm without a name use fzf to pick the argument, then run the same code path as the non-interactive form.

Both files live in the main worktree's root, one entry per line; lines starting with # are comments, blank lines are ignored. They are automatically applied when you run wt add (or manually with wt setup).

Files and directories listed here are copied into each new worktree. Use for:

• Environment files (.env.local, .env.*.local) — secrets and local config that vary per developer
• Hook directories (e.g. .husky/_) — git hooks shared across the repo but with filesystem state
• Any untracked files you want each worktree to have independently

Directories are copied with rsync -a, so internal symlinks survive (important for tools like husky).

Example:

# Environment files
frontend/.env.local
frontend/ikt-skip/.env.local

# Hook directories (internal symlinks preserved)
frontend/.husky/_

Missing entries are skipped without error (useful for optional files).

Glob patterns listed here are symlinked (not copied) into each new worktree, resolved against the main worktree. Use for:

• node_modules directories — avoid re-running yarn install in every worktree
• Build artifacts or other large read-only directories
• Any directory you want all worktrees to share (on the same filesystem)

⚠️ Important: Do not run yarn install (or any package manager) in a worktree with symlinked node_modules. If you need to change dependencies:

1. Run wt unsymlink to remove the symlinks
2. Run yarn install or your package manager
3. When you're done, create a new worktree with wt add to get fresh symlinks

Example:

# Symlink node_modules to avoid re-running yarn
frontend/node_modules
frontend/*/node_modules

The frontend/*/node_modules glob will match frontend/app-a/node_modules, frontend/app-b/node_modules, etc.

By default, wt add <name> creates the worktree as a sibling of the main repo:

parent/
  my-repo/        ← main worktree
  my-feature/     ← created by wt add my-feature

To use a different location, set WT_WORKTREE_DIR in your shell startup file:

# Inside the repo (add to .gitignore):
export WT_WORKTREE_DIR=.worktrees       # → my-repo/.worktrees/my-feature
export WT_WORKTREE_DIR=worktrees        # → my-repo/worktrees/my-feature

# Sibling directory:
export WT_WORKTREE_DIR=../worktrees     # → parent/worktrees/my-feature

# Absolute path:
export WT_WORKTREE_DIR=/tmp/worktrees   # → /tmp/worktrees/my-feature

Define WT_WORKTREE_DIR in ~/.zshenv (or ~/.bashrc), NOT ~/.zshrc (or ~/.bash_profile).

If you set it only in ~/.zshrc, it works when you run wt in your terminal, but fails silently when invoked by:

• Automation and scripts (including Claude Code's Bash tool)
• Editors and IDEs
• Git hooks
• CI/CD pipelines
• Any non-interactive shell invocation

This happens because zsh only sources ~/.zshrc for interactive shells. Non-interactive shells source ~/.zshenv (and ~/.zprofile/~/.zlogin for login shells) — but never ~/.zshrc. Similarly, bash only sources ~/.bashrc for interactive non-login shells; ensure non-interactive contexts load it too (or use ~/.bash_profile/~/.bashrc consistently).

When WT_WORKTREE_DIR is unset, wt silently falls back to the default location: a sibling directory of the main repo (e.g., ../my-feature). If worktrees appear in the wrong place, check your shell sourcing.

If you use an in-repo location (no leading ../), add it to .gitignore:

.worktrees/

• fzf — brew install fzf (only for the interactive picker)
• rsync (preinstalled on macOS and most Linux distros)

./bin/git-worktrees_test.sh

Creates a throwaway git repository in a temp directory, exercises all commands through their non-interactive forms, and asserts on filesystem state and output. No fzf needed.

Note: install.sh only supports zsh (writes to ~/.zshrc). Bash users should follow the manual installation below.

git clone https://github.com/dagjomar/git-worktrees.git
cd git-worktrees
./bin/install.sh
source ~/.zshrc

Add the following to your ~/.zshrc:

wt() {
  local script="/path/to/git-worktrees/bin/git-worktrees.sh"
  local dir
  case "${1:-}" in
    ls)
      dir=$("$script" "$@") && [ -n "$dir" ] && cd "$dir"
      ;;
    add)
      "$script" "$@" || return $?
      dir=$("$script" ls "${2:-}" 2>/dev/null) && [ -n "$dir" ] && cd "$dir"
      ;;
    rm)
      local main
      main=$(command git worktree list --porcelain 2>/dev/null | sed -n 's/^worktree //p' | head -1)
      "$script" "$@"
      # If we just removed the worktree we were standing in, move to main
      [ -d "$PWD" ] || cd "$main"
      ;;
    *)
      "$script" "$@"
      ;;
  esac
}