wt — git worktree workflow manager

A lightweight CLI for managing git worktrees with git-spice integration. Designed for running multiple Claude Code (or any AI coding agent) sessions in parallel on isolated branches.

Install

git clone https://github.com/areel/wt.git
cd wt
bash install.sh
source ~/.zshrc

Dependencies

• Required: fzf — brew install fzf
• Optional: git-spice — brew install git-spice

Usage

wt create <name>     # Create worktree + branch, register with git-spice
wt nav               # Interactively cd into a worktree
wt remove            # Interactively remove a worktree
wt remove -b         # Remove worktree AND delete its branch
wt list              # List all worktrees
wt help              # Show help

How it works

wt create my-feature does the following:

1. Creates a git worktree at ../my-feature (sibling to your repo)
2. Creates a branch named areel/my-feature (prefix configurable via WT_BRANCH_PREFIX)
3. Registers the branch with git-spice

You then open a Claude Code session (or any editor) in that directory and work normally. Commits, pushes, and pre-commit hooks all work as expected — each worktree is fully isolated.

Configuration

Variable	Default	Description
WT_BRANCH_PREFIX	areel	Prefix for branch names

Uninstall

bash uninstall.sh