Worktree manager

Buddy, worktrees are now easy. Don't even worry about it.

Usage

The workflow is all that matters here. Follow it and be happy.

Dependencies

• git
• go
• fzf (brew install fzf)

Setup

1. Crucial: wt clone <ssh url> - this clones as a bare repository
2. cd to repo
3. git worktree add main
4. cd main

Workflow

wt add <n> [b] - sets up a worktree named <n>, optionally tracking branch [b]. wt rm - launches fzf with the worktrees you can remove.

Easy right?

Build

go build -o wt

Note

Add this to your path, e.g. export PATH=$HOME/<path to cloned directory>/wt:$PATH

Change directories

To make changing directories work, add this to your ~/.zshrc.

# wt — worktree manager (shell wrapper for cd support)
wt() {
  local out exit_code
  out=$(command wt "$@")
  exit_code=$?
  if [[ -n "$out" && -d "$out" ]]; then
    cd "$out"
  elif [[ -n "$out" ]]; then
    print -- "$out"
  fi
  return $exit_code
}

Note

Don't forget to run source .zshrc or zsh for the changes to take effect.

Completion

Add the following line to your ~/.zshrc

source <(wt completion zsh)

Note

Don't forget to run source .zshrc or zsh for the changes to take effect.

All options

wt                          # fzf picker, enter to cd
wt add <n> [b]              # add worktree at ../<n>, symlink .wt-include dirs
wt rm [name]                # remove worktree (fzf if omitted)
wt clone <url> [name]       # SSH bare clone into ./<name>/.git, fix fetch refspec
wt list                     # list all worktrees
wt link                     # symlink .wt-include dirs into current worktree
wt completion zsh           # print zsh completion script