██████   ██      ██
 ██        ██      ██
 ██   ███  ██  ██  ██
 ██    ██   ██ ██ ██                        --- Git Worktree Tools ---
  ██████     ██  ██
 _____ ___   ___  _           A CLI for managing Git worktrees with automatic file syncing
|_   _/ _ \ / _ \| |                            and enhanced navigation.
  | || (_) | (_) | |__
  |_| \___/ \___/|____|

Git Worktree Tools - A CLI for managing Git worktrees with automatic file syncing and enhanced navigation.

gw simplifies Git worktree management with features like:

• Create worktrees with automatic file copying (.env, secrets, configs)
• Quick navigation with gw cd and smart partial matching
• Proxy commands for git worktree operations with enhanced output

-> See docs <-

# Clone and set up repository with gw
gw init git@github.com:user/repo.git

# Create a new worktree (auto-creates branch if needed, auto-copies files)
gw add feature-auth

# Navigate to worktree
gw cd feature-auth

# Sync files between worktrees
gw sync feature-auth .env secrets/

# List all worktrees
gw list

# Remove when done
gw remove feature-auth

Install the gw CLI tool, then add shell integration to your shell config for commands like gw cd:

brew install mthines/gw-tools/gw

npm install -g @gw-tools/gw

yay -S gw-tools

Then add to your shell config (~/.zshrc or ~/.bashrc):

eval "$(gw install-shell)"

For Fish, add to ~/.config/fish/config.fish:

gw install-shell | source

📖 Full documentation: packages/gw-tool/README.md

VS Code users: Install the gw-worktrees extension for integrated worktree management.

The two gw-specific skills shipped from this repo:

• git-worktree-workflows — Master Git worktrees and gw workflows
• gw-config-management — Configure gw for your project type (Next.js, monorepos, etc.)

Install the gw-specific skills:

npx skills add https://github.com/mthines/gw-tools \
  --skill git-worktree-workflows gw-config-management \
  --agent claude-code \
  --yes

For the autonomous workflow and other coding-assistant skills (autonomous-workflow, create-plan, create-walkthrough, confidence, tdd, ux, code-quality, holistic-analysis, …), see the dedicated mthines/agent-skills repository.

This project is licensed under the MIT License.

While not required beyond keeping the license file, we appreciate a mention or link back to gw-tools if you find it useful in your own projects.