A fast, interactive CLI for managing git worktrees. Create, switch, list, and remove worktrees with fuzzy search and a beautiful TUI.

curl -fsSL https://raw.githubusercontent.com/sushidev-team/worktree-manager/main/install.sh | sh

Or specify a custom install directory:

INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/sushidev-team/worktree-manager/main/install.sh | sh

brew install sushidev-team/tap/wt

go install github.com/sushidev-team/worktree-manager@latest

Download the latest binary for your platform from Releases.

wt needs a shell wrapper to change directories. Add this to your ~/.zshrc or ~/.bashrc:

eval "$(wt init-shell)"

Then restart your shell or run source ~/.zshrc.

wt

Opens a full-screen interactive TUI with all your worktrees. Features:

• Fuzzy search — type / to filter worktrees
• Enter — switch to the selected worktree
• a — add a new worktree (with branch picker)
• d — delete the selected worktree
• q — quit

# Interactive branch picker
wt add my-feature

# Specify base branch directly
wt add my-feature --base main

Creates a new worktree as a sibling directory and switches to it. For a repo at ~/code/myrepo, the worktree is created at ~/code/myrepo--my-feature.

wt use my-feature

# Fuzzy matching works — just type enough to be unique
wt use feat

wt list

NAME                  BRANCH        COMMIT   STATUS              PATH
myrepo (main)         main          a1b2c3d  ● current           ~/code/myrepo
my-feature            my-feature    d4e5f6a  ✱ dirty             ~/code/myrepo--my-feature
bugfix                fix/login     b7c8d9e                      ~/code/myrepo--bugfix

ls works as an alias: wt ls

wt remove my-feature

# Skip confirmation
wt remove my-feature --force

rm works as an alias: wt rm my-feature

• Worktrees are created as sibling directories using a -- separator: repo--worktree-name
• Each worktree gets its own branch (named after the worktree)
• The shell wrapper function captures the path output from wt and cds into it
• Dirty worktrees (uncommitted changes) are flagged in both list and interactive views

MIT