AI Skills

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

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

🛠️ gw CLI Tool

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 <-

Installation

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

# Homebrew (macOS & linux)
brew install mthines/gw-tools/gw

# Linux
yay -S gw-tools

# npm (auto-adds shell integration)
npm install -g @gw-tools/gw

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

Quick Start

# 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

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

🎓 AI Skills (for Claude Code, Copilot, Cursor, etc.)

Enhance your AI agent with gw-tools knowledge using skills.sh:

npx skills add https://github.com/mthines/gw-tools --skill @gw-git-worktree-workflows @gw-config-management @gw-autonomous-workflow # installs all skills

# Autonomous feature development workflow
npx skills add https://github.com/mthines/gw-tools --skill @gw-autonomous-workflow

# Master Git worktrees and gw workflows
npx skills add https://github.com/mthines/gw-tools --skill @gw-git-worktree-workflows

# Configure gw for your project type (Next.js, monorepos, etc.)
npx skills add https://github.com/mthines/gw-tools --skill @gw-config-management

Once installed, your AI agent can:

Execute complete feature development cycles autonomously
Create worktrees for bug fixes and features automatically
Configure gw for your specific project type
Navigate between worktrees and manage files
Create tested PRs from isolated worktrees

📖 Skill documentation: skills/README.md

Name	gw-config-management
Description	Configure and optimize gw-tools for different project types and team needs. Use this skill when setting up gw for new projects, configuring auto-copy files, troubleshooting configuration issues, or customizing gw for Next.js, Node.js APIs, monorepos, or React SPAs. Triggers on tasks involving .gw/config.json, auto-copy patterns, environment files, or gw init commands.

gw-config-management

SKILL.md

🛠️ gw CLI Tool

Installation

Quick Start

🎓 AI Skills (for Claude Code, Copilot, Cursor, etc.)