git-wt
Enhanced Git worktree management with interactive features
git-wt
A Git custom command that makes Git worktrees easier to use with interactive selection, safer destructive flows, repository migration, diagnostics, and compact dashboards.
git-wt uses a bare repository structure
where Git data lives in .bare/ and each branch gets its own sibling
worktree directory.
Features
- Bare clone structure with
.bare/for Git data - Interactive add / switch / remove flows with fzf
- Repository migration from a standard repo to the bare worktree layout
- Safe cleanup filters with
git wt remove --sweep - Repository diagnostics with
git wt doctor - Status dashboard with
git wt status - Structured output with
git wt list --json - Dry-run support for destructive operations
Quick Start
Installation
Homebrew
brew tap ahmedelgabri/git-wt
brew install git-wt
Nix Flakes
nix run github:ahmedelgabri/git-wt
Basic Usage
# Clone with the bare worktree layout
git wt clone https://github.com/user/repo.git
# Migrate an existing repo
git wt migrate
# Create a worktree interactively
git wt add
# Switch between worktrees
cd "$(git wt switch)"
# Show repository health
git wt doctor
# Show status for all worktrees
git wt status
# Sweep safe cleanup candidates
git wt remove --sweep --dry-run
Repository Structure
When you clone with git wt clone, you get:
repo/
├── .bare/ # Git data (bare repository)
├── .git # Points to .bare
└── main/ # Worktree for default branch
Commands
| Command | Description |
|---|---|
clone <url> |
Clone a repo with the bare worktree structure |
migrate |
Convert an existing repo to the bare worktree structure |
add [options] ... |
Create a new worktree |
remove [worktree] |
Remove worktrees directly or by safe cleanup filters |
doctor |
Run repository diagnostics |
status |
Show a compact dashboard for linked worktrees |
list |
List worktrees with table, JSON, or passthrough Git output |
switch |
Interactive worktree selection |
update |
Fetch remotes and update the default branch |
Native git worktree commands (lock, unlock, move, prune, repair) are also supported as pass-through commands.
Dependencies
git(2.48.0+for relative worktree support)