Repository navigation
Releases
v3.1.0
Changes
- chore: release v3.1.0
- feat: require Git 2.48.0 for relative worktrees
- docs: simplify README and add mise release instructions
Installation
Requires Git 2.48.0 or newer.
Using Homebrew
brew install ahmedelgabri/tap/git-wtUsing mise
mise use "github:ahmedelgabri/git-wt"Using Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-3.1.0-<OS>-<ARCH>.tar.gz
cp git-wt-3.1.0-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-3.1.0-checksums.txt
v3.0.0
Changes
- fix: prevent data loss across worktree workflows (#33)
- docs: add mise installation method
- ci: bump tap formula version via release URLs
Installation
Using Homebrew
brew install ahmedelgabri/tap/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-3.0.0-<OS>-<ARCH>.tar.gz
cp git-wt-3.0.0-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-3.0.0-checksums.txt
v2.1.0
Highlights
Worktree lifecycle hooks
Run shell commands around worktree creation and removal, configured through Git config so they can be scoped per repository or globally (adapted from k1LoW/git-wt, #21 thanks @cwill747):
git config --add wt.beforeadd './scripts/check-worktree.sh'
git config --add wt.afteradd 'cp ../main/compile_commands.json .'
git config --add wt.beforeremove './scripts/cleanup-worktree.sh'
git config --add wt.afterremove 'workspace-registry remove "$GIT_WT_PATH"'- Four events:
wt.beforeadd,wt.afteradd,wt.beforeremove,wt.afterremove— before-hooks can veto the operation by exiting non-zero. - Hooks receive context via
GIT_WT_EVENT,GIT_WT_PATH,GIT_WT_BRANCH, andGIT_WT_BARE_ROOTenvironment variables. - Repeated
git config --addvalues run in order and stop at the first failure; multiline values are supported. - Hook output goes to stderr, so
git wt add's stdout stays machine-readable.DEBUG=1echoes hooks instead of running them.
See the Hooks section in the README for the full lifecycle table and failure semantics.
Shell integration: git wt switch now cds for you
A new init command emits a shell wrapper (the zoxide/direnv pattern) so git wt switch changes directory directly instead of requiring cd "$(git wt switch)" — thanks @milesd (#26):
# bash (~/.bashrc)
eval "$(git-wt init bash)"
# zsh (~/.zshrc)
eval "$(git-wt init zsh)"
# fish (~/.config/fish/config.fish)
git-wt init fish | source- Only
switchis intercepted:git wt addkeeps printing the created worktree path to stdout, so scripts, hooks, and the Claude CodeWorktreeCreateintegration keep working unchanged. - A thin
git()wrapper makes thegit wt switchspelling work too; use--no-git-wrapperif another tool already wrapsgit. - Known limitation: global git flags before the subcommand (e.g.
git -C <path> wt switch) bypass the wrapper and print the path instead.
Changes
- feat: add worktree lifecycle hooks, migrated from https://github.com/k1LoW/git-wt (#21)
- feat(init): add shell integration for automatic directory changing (#26)
- docs: list shell integration and lifecycle hooks in features
- chore: bump version to 2.1.0
Installation
Using Homebrew
brew install ahmedelgabri/tap/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-2.1.0-<OS>-<ARCH>.tar.gz
cp git-wt-2.1.0-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-2.1.0-checksums.txt
v2.0.4
Changes
- chore: bump version to 2.0.4
- fix: migrate slash-named branches (#32)
- fix: make tables responsive in narrow terminals (#31)
- chore: drop x86_64-darwin and bump flake inputs
Installation
Using Homebrew
brew install ahmedelgabri/tap/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-2.0.4-<OS>-<ARCH>.tar.gz
cp git-wt-2.0.4-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-2.0.4-checksums.txt
v2.0.3
Changes
- chore: bump version to 2.0.3
- feat: add installable git-wt agent skill
- chore: switch Homebrew updates to shared tap
- docs: add Claude Code integration section to README (#23)
- docs: add Claude Code integration section to README (#22)
Installation
Using Homebrew
brew install ahmedelgabri/tap/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-2.0.3-<OS>-<ARCH>.tar.gz
cp git-wt-2.0.3-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-2.0.3-checksums.txt
v2.0.2
Changes
- fix: install zsh bridge for
git wtcompletions - fix(ci): check remote tags to prevent immutable release errors
Installation
Using Homebrew
brew install ahmedelgabri/git-wt/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-2.0.2-<OS>-<ARCH>.tar.gz
cp git-wt-2.0.2-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-2.0.2-checksums.txt
v2.0.1
Changes
Installation
Using Homebrew
brew install ahmedelgabri/git-wt/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-2.0.1-<OS>-<ARCH>.tar.gz
cp git-wt-2.0.1-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-2.0.1-checksums.txt
v2.0.0
Changes
- chore: bump version to 2.0.0
- refactor: make list a native passthrough
- fix: resolve main CI failures and refresh vendor hash
- refactor: group root help output into sections
- ui: passthrough raw git output for clone and fetch
- ui: remove task output padding and show full output for clone add
- perf: benchmark picker paths at 1k 5k and 10k
- refactor: extract picker args and build before test runs
- perf: benchmark large interactive picker paths
- ui: add structured async command steps
- ui: normalize report sections and shared table footers
- ui: add async doctor reports and refine status phases
- ui: preload switch and remove selectors asynchronously
- add: preload interactive branch selection asynchronously
- ui: add shared async task runner and context-aware git execution
- ui: add shared runtime helpers and prompt parity
- fix: print created worktree path to stdout
- feat: diagnostics dashboards and hardened worktree flows (#18)
- OCD
Installation
Using Homebrew
brew install ahmedelgabri/git-wt/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-2.0.0-<OS>-<ARCH>.tar.gz
cp git-wt-2.0.0-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-2.0.0-checksums.txt
v1.2.1
Changes
- chore: bump version to 1.2.1
- fix: handle symlink overwrite in CopyDir during migrate
- feat: show git command output and add program lifecycle tests
Installation
Using Homebrew
brew install ahmedelgabri/git-wt/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-1.2.1-<OS>-<ARCH>.tar.gz
cp git-wt-1.2.1-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-1.2.1-checksums.txt
v1.2.0
Changes
- fix: reject clone into existing directory
- fix: set GH_TOKEN for gh CLI in release workflow
Installation
Using Homebrew
brew install ahmedelgabri/git-wt/git-wtUsing Nix Flakes
nix run github:ahmedelgabri/git-wtManual Download
Download the archive for your platform, extract it, and place the binary in your $PATH:
tar xzf git-wt-1.2.0-<OS>-<ARCH>.tar.gz
cp git-wt-1.2.0-<OS>-<ARCH>/git-wt ~/.local/bin/Completions and man pages are included in the archive under completions/ and man/.
Checksums: See git-wt-1.2.0-checksums.txt