Skip to content

wt

Git Worktree Manager with iTerm2 + Claude Code integration.

wt creates git worktrees with dedicated iTerm2 windows — Claude Code on top, shell on bottom — and tracks them across repos. Full lifecycle management from branch creation to merge.

Quick Start

wt create feature/auth       # Create worktree + open iTerm2 window
wt list                      # See all active worktrees
wt sync feature/auth         # Pull latest main into your branch
wt merge feature/auth        # Merge into main + auto-cleanup

Documentation

Section Description
Getting Started Installation, shell completions, first worktree walkthrough
Commands Complete reference for every command, flag, and alias
Configuration Config file, environment variables, merge strategy
Concepts Worktree layout, iTerm2 integration, sync strategies
Troubleshooting Common issues and solutions

Prerequisites

wt requires macOS, iTerm2, and git. Optionally install the GitHub CLI (gh) for pull request support.