Skip to content

Releases

v3.1.0

Choose a tag to compare

@github-actions github-actions released this 10 Oct 10:44
Immutable release. Only release title and notes can be modified.
01dd44c

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-wt

Using mise

mise use "github:ahmedelgabri/git-wt"

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 08 Oct 20:01
Immutable release. Only release title and notes can be modified.
cf90268

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-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 28 Jul 18:11
Immutable release. Only release title and notes can be modified.
76f2bc0

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, and GIT_WT_BARE_ROOT environment variables.
  • Repeated git config --add values 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=1 echoes 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 switch is intercepted: git wt add keeps printing the created worktree path to stdout, so scripts, hooks, and the Claude Code WorktreeCreate integration keep working unchanged.
  • A thin git() wrapper makes the git wt switch spelling work too; use --no-git-wrapper if another tool already wraps git.
  • 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-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 13 Jul 21:42
Immutable release. Only release title and notes can be modified.
6789bba

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-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 19 Jun 21:53
Immutable release. Only release title and notes can be modified.
7528a13

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-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 28 Apr 09:21
Immutable release. Only release title and notes can be modified.
236fc8d

Changes

  • fix: install zsh bridge for git wt completions
  • fix(ci): check remote tags to prevent immutable release errors

Installation

Using Homebrew

brew install ahmedelgabri/git-wt/git-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 01 Apr 23:18
Immutable release. Only release title and notes can be modified.
57b2a16

Changes

Installation

Using Homebrew

brew install ahmedelgabri/git-wt/git-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 28 Mar 20:53
Immutable release. Only release title and notes can be modified.
e01cb40

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-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 23 Feb 13:22
Immutable release. Only release title and notes can be modified.
450c479

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-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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

Choose a tag to compare

@github-actions github-actions released this 23 Feb 10:27
Immutable release. Only release title and notes can be modified.
441d093

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-wt

Using Nix Flakes

nix run github:ahmedelgabri/git-wt

Manual 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