git-worktree-switcher icon indicating copy to clipboard operation
git-worktree-switcher copied to clipboard

Switch between git worktrees with speed. :zap:

Git worktree switcher:zap:

Switch between git worktrees with speed. :zap:

demo of switching between git worktrees

Installation

Download the script from the Release section.

Make the script executable.

$ chmod +x wt

Copy the executable to any directory in your $PATH

$ sudo cp wt /usr/local/bin

Note for Mac Users

git-work-tree switcher relies on GNU grep, which is not avaiable on Mac.

To use this tool:

  • install GNU grep
    brew install grep
    
  • Add gnubin directory to your PATH
    export PATH="/opt/homebrew/opt/grep/libexec/gnubin:$PATH"
    

Tab Autocompletion :zap:

For Bash

sudo cp completions/wt_completion /etc/bash_completion.d

For ZSH

Note: completion file for zsh has _ prefix

Find paths where you can store your completion

print -rl -- $fpath

Copy completion script to one of that location and restart the shell.

sudo cp completions/_wt_completion <one-of-$fpath>

exec zsh

For Fish

cp completions/wt.fish ~/.config/fish/completions

Tab autocompletion works for switching between your worktrees.

wt <TAB> <TAB>

# OR

wt <completion-characters> <TAB>

Usage

Switch between worktrees. You can do a text search to change to the worktree directory.

$ wt <worktree-name/search-term>

Go to root worktree directory

$ wt -

List out all the worktrees.

$ wt list

Show help message

$ wt help

Update to the latest release

$ wt update

Show the CLI version

$ wt version