GWTree

Git worktree manager for parallel development

Create and manage git worktrees effortlessly. Run multiple AI agents in parallel — Claude Code, Command Code, Cursor on separate branches simultaneously.

Installation

npm install -g gwtree

Usage

Multi-Agent Parallel Execution

gwt auth api dashboard -x    # Create 3 worktrees instantly, no editor popups

Spin up isolated worktrees for multiple AI agents to work in parallel:

• Claude Code → repo-auth/ fixing authentication
• Command Code → repo-api/ building API endpoints
• Cursor → repo-dashboard/ creating UI components

Each agent works on its own branch without conflicts. Merge when ready with gwt merge.

Create Worktree

gwt                    # Interactive mode
gwt feature-login      # Quick: creates repo-feature-login worktree with feature-login branch
gwt feature-login -y   # Fast: skip all prompts, use saved defaults
gwt auth api dashboard # Batch: create multiple worktrees at once
gwt a b c -x           # Batch + skip editor opens

Interactive prompts guide you through:

1. Name — Enter name for both worktree and branch (press ESC to set separately)
2. Stash/Switch — Handle uncommitted changes and switch to main
3. Pull — Fetch latest changes from remote

The CLI shows each command as it runs with full transparency.

List & Remove Worktrees

gwt ls                 # List all worktrees for current repo
gwt rm                 # Interactive search and remove

Status Dashboard

gwt status             # Show status of all worktrees
gwt st                 # Alias

Shows for each worktree: changes, commits ahead/behind, merge status.

Clean Merged Worktrees

gwt clean              # Remove worktrees that have been merged to main
gwt clean --all        # Remove all worktrees

Merge & Cleanup

gwt merge feature      # Merge branch to main, remove worktree, delete branch

Automates: checkout main, merge, remove worktree, delete branch.

Features

Batch creation Create multiple worktrees at once: gwt dashboard api auth

Status dashboard See changes, commits ahead/behind, merge status for all worktrees

Smart cleanup Auto-remove merged worktrees, or clean all with --all

Merge helper One command to merge, remove worktree, and delete branch

Quick worktree creation Minimal prompts, smart defaults, transparent command output

Smart naming Pattern: {repo}-{name} with matching branch name

Interactive management List, search, and delete worktrees

Clean UX Compact output with └ brackets, ESC for separate worktree/branch names

Configuration

Manage defaults with gwt config or gwt config reset.

Settings stored in ~/.config/gwtree/config.json:

• editor — code, cursor, default, or none
• installDeps — Auto-install dependencies (true/false)
• lastPm — Last used package manager

Commands

| Command | Alias | Description | |---------|-------|-------------| | gwt | gwtree | Create new worktree (interactive) | | gwt [name] | — | Create worktree + branch with name | | gwt a b c | — | Batch create multiple worktrees | | gwt [name] -y | — | Fast mode, skip all prompts | | gwt [name] -x | --no-editor | Skip opening editor | | gwt ls | list | List worktrees for current repo | | gwt rm | remove | Interactive search and remove | | gwt status | st | Show status of all worktrees | | gwt clean | c | Remove merged worktrees | | gwt clean -a | --all | Remove all worktrees | | gwt merge <name> | m | Merge branch to main and cleanup | | gwt config | — | Open config file | | gwt config reset | — | Reset to defaults | | gwt -v | --version | Show version | | gwt -h | --help | Show help |

Why GWTree?

Built for the AI-assisted development era:

• Multi-agent parallelism — Run Claude Code, Command Code, Cursor on separate features simultaneously
• Instant worktree creation — gwt a b c -x creates 3 isolated environments in seconds
• Clean merges — Each agent works on its own branch, merge when ready
• Zero conflicts — No stashing, no branch switching, no context loss

MIT License by Ahmad Awais.