Interactive TUI for cleaning up git worktrees.

Scans your repository for worktrees that are merged, stale, or detached and lets you remove them in bulk or individually — without touching your active work.

• Detects merged branches (including squash-merges)
• Detects remote-gone branches and detached HEADs
• Marks worktrees with no recent commits as stale
• Category-based bulk removal or individual selection via fzf
• Dry-run mode to preview what would be removed
• Configurable stale threshold
• Colored terminal output (degrades gracefully in non-TTY environments)

• bash >= 4
• git
• fzf

One-liner:

curl -fsSL https://raw.githubusercontent.com/mbensch/wtkill/main/install.sh | bash

Manual:

git clone https://github.com/mbensch/wtkill.git
cd wtkill
bash install.sh

By default wtkill is installed to ~/.local/bin. Override with PREFIX:

PREFIX=/usr/local/bin bash install.sh

If the install directory is not on your $PATH, the script will tell you how to add it.

wtkill [OPTIONS]

Environment variable:

1. Optionally runs git fetch --prune to sync remote state.
2. Parses all worktrees via git worktree list --porcelain.
3. Classifies each worktree as merged, stale, detached, or active based on merge status, squash-merge detection, remote branch existence, and last commit date.
4. Presents an interactive menu to toggle categories for bulk removal, or launches fzf for individual selection.
5. Removes selected worktrees with git worktree remove --force and runs git worktree prune.

Lint with ShellCheck:

shellcheck wtkill install.sh

Run tests with bats:

bats test/

Both run automatically on every PR via GitHub Actions.

MIT