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 the bare repository structure
where Git data lives in .bare/ and each branch gets its own sibling
worktree directory.
Git worktrees let you keep multiple branches checked out at the same time in separate directories. They are useful for:
- working on multiple features in parallel without stashing
- reviewing PRs while keeping local work intact
- comparing implementations side by side
- running tests on one branch while developing on another
- 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
- Preserves uncommitted changes, stashes, remotes, and repo-local config during migration
git(2.48.0+for relative worktree support)
brew tap ahmedelgabri/git-wt
brew install git-wtShell completions are installed automatically for bash, zsh, and fish.
Add to your flake inputs:
{
inputs.git-wt.url = "github:ahmedelgabri/git-wt";
}Then add to your packages:
inputs.git-wt.packages.${system}.defaultOr run directly:
nix run github:ahmedelgabri/git-wtDownload the latest release archive for your platform from the releases page:
curl -sL https://github.com/ahmedelgabri/git-wt/releases/latest/download/git-wt-VERSION-OS-ARCH.tar.gz | tar xz
cp git-wt-VERSION-OS-ARCH/git-wt ~/.local/bin/Replace VERSION with the current release version and choose the correct
platform archive.
For manual installs, the release archives include a completions/ directory:
# Bash
cp completions/git-wt.bash ~/.local/share/bash-completion/completions/git-wt
# Zsh
cp completions/_git-wt ~/.local/share/zsh/site-functions/_git-wt
# Fish
cp completions/git-wt.fish ~/.config/fish/completions/git-wt.fishgit wt clone https://github.com/user/repo.gitThis creates:
repo/
├── .bare/ # Git data (bare repository)
├── .git # gitdir pointer to .bare
└── main/ # Worktree for the default branch
cd existing-repo
git wt migrateThis converts a standard Git repository into the bare worktree layout while preserving tracked changes, untracked files, stashes, remotes, and selected repo-local config.
# Interactive mode
git wt add
# From a remote branch
git wt add feature origin/feature
# Create a new branch
git wt add -b new-feature new-feature
# Detached, locked, or quiet modes
git wt add --detach hotfix HEAD~5
git wt add --lock -b wip wip-branch
git wt add --quiet -b feature featurecd "$(git wt switch)"git wt remove feature-branch
git wt remove --dry-run feature-branchgit wt remove feature-branch --delete-remotegit wt remove --sweep
git wt remove --sweep --dry-rungit wt doctorgit wt statusgit wt list
git wt list --json
git wt list --porcelaingit wt update # or: git wt u| 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 / rm |
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 |
Interactively select a worktree |
update / u |
Fetch remotes and update the default branch |
Native git worktree commands (lock, unlock, move, prune, repair)
are also supported as pass-through commands.
# Enter development shell
nix develop
# Format code
nix fmt
# Run all checks
nix flake checkMIT
