Installation

Get wt up and running in minutes on macOS, Linux, or WSL.

Requirements

fzf (required)

Fuzzy finder for interactive selection. github.com/junegunn/fzf

gh (optional)

GitHub CLI for PR and issue integration. cli.github.com

jq (optional)

JSON parser for enhanced PR/Issue display. stedolan.github.io/jq

claude (optional)

Claude Code CLI for AI-powered features. claude.ai/code

Install wt

Homebrew Installation

The easiest way to install wt on macOS is via Homebrew. Dependencies (fzf, gh, jq) are installed automatically.

bash

brew tap AThevon/wt && brew install wt

Run Setup

After installation, run the setup wizard to configure your shell:

bash

wt --setup

All set!

Restart your terminal or run source ~/.zshrc to start using wt.

Uninstall

macOS (Homebrew)

bash

brew uninstall wt
brew untap AThevon/wt

Linux / WSL

bash

sudo rm /usr/local/bin/wt-core

Then remove from your ~/.zshrc or ~/.bashrc:

~/.zshrc

# wt - Git Worktree Manager
eval "$(wt-core --shell-init)"

Verify Installation

Check that wt is correctly installed by running:

bash

wt --version

You can also run wt --setup at any time to check the status of your dependencies, or wt --wizard to re-run the preferences wizard (editor, platform, etc.).