Installation

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

Requirements

fzf (required)

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

gum (required)

Styled UI components (spinners, prompts, inputs). github.com/charmbracelet/gum

jq (required)

JSON parser for PR/Issue display and data processing. stedolan.github.io/jq

gh (optional)

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

glab (optional)

GitLab CLI for MR and issue integration. gitlab.com/gitlab-org/cli

claude (optional)

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

Install worktigre

Homebrew Installation

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

bash

brew tap AThevon/worktigre && brew install worktigre

Run Setup

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

bash

wt --wizard

All set!

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

Uninstall

macOS (Homebrew)

bash

brew uninstall worktigre
brew untap AThevon/worktigre

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 worktigre 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.).