wt - Universal Git Worktree Manager

A powerful CLI tool for managing Git worktrees with automatic project setup.

Features

• Universal Project Support: Flutter, Rust, npm/yarn/pnpm/bun, Python/Django, Go, Ruby, PHP
• Automatic Setup: Runs package manager install after creating worktree
• Config Sync: Copies .vscode, .claude, folders to new worktrees
• Quick Navigation: wt go <name> instantly changes directory to worktree
• GitHub PR Workflow: Create PR, merge, and cleanup with single command

Installation

Quick Install

# Download and install
curl -fsSL https://raw.githubusercontent.com/omert11/wt/main/install.sh | bash

Manual Install

# Clone the repo
git clone https://github.com/omert11/wt.git
cd wt

# Copy script to local bin
mkdir -p ~/.local/bin
cp wt ~/.local/bin/_wt
chmod +x ~/.local/bin/_wt

# Create shell wrapper function
cat > ~/.local/bin/wt.sh << 'EOF'
# wt - Git Worktree Manager wrapper
wt() {
    if [[ "$1" == "go" || "$1" == "g" || "$1" == "claude" || "$1" == "c" ]]; then
        local cmd
        cmd=$(_wt "$@")
        if [[ $? -eq 0 && -n "$cmd" ]]; then
            eval "$cmd"
        fi
    else
        _wt "$@"
    fi
}
EOF

# Add to shell config (~/.zshrc or ~/.bashrc)
echo '[ -f ~/.local/bin/wt.sh ] && source ~/.local/bin/wt.sh' >> ~/.zshrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

# Reload shell
source ~/.zshrc

Usage

Commands

Command	Alias	Description
wt init	-	Initialize wt for this project (creates .wtconfig)
wt new [name] [base]	n	Create new worktree or pick from existing branches
wt go <name>	g	Change directory to worktree
wt claude [name]	c	Open Claude Code in worktree
wt top	-	Go to main repo directory
wt merge [name]	m	Create PR, merge, and cleanup worktree
wt list	ls	List all worktrees
wt status	st	Show status of all worktrees
wt remove <name>	rm	Remove a worktree
wt clean	-	Remove all worktrees
wt path <name>	p	Print worktree path
wt type	t	Show detected project type
wt help	h	Show help

Examples

# Initialize wt in your project (required before first use)
wt init

# Create worktree with new branch (interactive base selection)
wt new auth

# Create worktree from specific base branch (no prompt)
wt new bugfix develop

# Pick from existing branches interactively
wt new

# Go to existing worktree
wt go auth

# Open Claude Code in worktree
wt claude auth

# Go back to main repo
wt top

# Complete workflow: PR → merge → cleanup
wt merge auth

# List all worktrees
wt ls

# Check status of all worktrees
wt st

Interactive Base Branch Selection

When you run wt new <name> without specifying a base branch, an interactive menu lets you choose which branch to branch from:

$ wt new auth

Base branch seçin:

  1) main (default)
  2) develop
  3) staging

Select base branch (number) [1]: _

• Press Enter to use the default branch
• Enter a number to select a different base
• The selected base is saved and used by wt merge to target the correct PR base

If you specify the base explicitly (wt new auth develop), the prompt is skipped.

Workflow

Creating a Feature

# 0. Initialize wt (one-time per project)
wt init

# 1. Create new worktree (select base branch interactively)
wt new my-feature

# 2. Go to the worktree
wt go my-feature

# 3. Work on your feature...

# 4. When done, merge and cleanup (PR targets the correct base)
wt merge my-feature

Worktree Structure

your-project/                    # Main repo
../your-project-worktrees/       # Worktrees directory
├── feature-1/                   # Worktree for feature-1
├── feature-2/                   # Worktree for feature-2
└── bugfix/                      # Worktree for bugfix

Configuration

wt requires a .wtconfig file in your project root. Create it with wt init.

Config is layered (later overrides earlier):

1. Default config - Built into the script
2. Global config - ~/.config/wt/config
3. Project config - .wtconfig in project root (required, created by wt init)

Managing Config

# Initialize project config (required before first use)
wt init

# Show current configuration
wt config

# Edit global config (creates if not exists)
wt config edit

Config Options

# Folders to copy from main repo to worktree
COPY_FOLDERS=(
    ".vscode"
    ".claude"
)

# Files to copy from main repo to worktree
COPY_FILES=(
    ".env"
)

# Worktree directory pattern
WORKTREE_DIR_PATTERN="../{project}-worktrees"

# Commands to run after worktree creation
INIT_COMMANDS=(
    "cp .env.example .env"
    "make setup"
)

# PR merge method: squash, merge, rebase
PR_MERGE_METHOD="squash"

# Delete branch after merge
PR_DELETE_BRANCH=true

# Auto-confirm merge (skip confirmation prompt)
PR_AUTO_MERGE=false

Project-Specific Config

Run wt init to create a .wtconfig file in your project root. This file is required and should be committed to git so your team shares the same worktree settings.

Supported Project Types

Project	Detection	Auto Setup
Flutter	pubspec.yaml	flutter pub get + build_runner
Rust	Cargo.toml	cargo fetch
Node.js	package.json	npm/yarn/pnpm/bun install
Python	pyproject.toml, requirements.txt	poetry/uv/pip install
Go	go.mod	go mod download
Ruby	Gemfile	bundle install
PHP	composer.json	composer install

Requirements

• Git
• GitHub CLI (gh) - for merge command

License

MIT