Getting Started

Willow is a git worktree manager built for AI agent workflows. It gives every task its own isolated directory via git worktrees, then adds fzf-based switching and live agent status tracking on top.

Install

Homebrew

brew install iamrajjoshi/tap/willow

From source

go install github.com/iamrajjoshi/willow/cmd/willow@latest

Requirements

• git
• fzf — for ww sw and ww rm interactive picker

Shell integration

Add to your .bashrc / .zshrc:

eval "$(willow shell-init)"

For fish:

willow shell-init | source

This gives you:

Command	Description
ww <cmd>	Alias for willow
ww sw	fzf worktree switcher (cd's into selection)
wwn <branch>	Create worktree + cd into it
www	cd to ~/.willow/worktrees/

Terminal tab titles (optional)

Set terminal tab title to the current worktree name:

eval "$(willow shell-init --tab-title)"

Each tab shows repo/branch (e.g. myrepo/auth-refactor) when inside a willow worktree.

Claude Code status tracking

ww cc-setup

Installs hooks into ~/.claude/settings.json that write agent status (BUSY / DONE / WAIT / IDLE) to ~/.willow/status/. This powers the status column in ww ls, ww sw, and ww status.

Quick start

# Clone a repo (one-time)
ww clone git@github.com:org/myrepo.git

# Create a worktree and cd into it
wwn auth-refactor

# Start Claude Code
claude

# In another terminal — create a second worktree
wwn payments-fix
claude

# Switch between worktrees (fzf picker with agent status)
ww sw

# Check on all agents
ww status

# Clean up when done
ww rm auth-refactor

Terminal setup

Recommended Ghostty layout per worktree:

┌─────────────────────────────────────┐
│ Tab: myrepo/auth-refactor           │
├──────────────────┬──────────────────┤
│  claude          │  claude          │
│  (agent 1)       │  (agent 2)      │
├──────────────────┴──────────────────┤
│  shell (git diff, tests, etc.)      │
└─────────────────────────────────────┘