A CLI tool for managing git worktrees with a filesystem-like interface.
# Apple Silicon (M1/M2/M3)
curl -L https://github.com/sawradip/gwt/releases/latest/download/gwt-darwin-arm64 -o gwt
chmod +x gwt && sudo mv gwt /usr/local/bin/
# Intel Mac
curl -L https://github.com/sawradip/gwt/releases/latest/download/gwt-darwin-amd64 -o gwt
chmod +x gwt && sudo mv gwt /usr/local/bin/# x64
curl -L https://github.com/sawradip/gwt/releases/latest/download/gwt-linux-amd64 -o gwt
chmod +x gwt && sudo mv gwt /usr/local/bin/
# ARM64
curl -L https://github.com/sawradip/gwt/releases/latest/download/gwt-linux-arm64 -o gwt
chmod +x gwt && sudo mv gwt /usr/local/bin/# Download and add to PATH
Invoke-WebRequest -Uri "https://github.com/sawradip/gwt/releases/latest/download/gwt-windows-amd64.exe" -OutFile "gwt.exe"
Move-Item gwt.exe C:\Windows\System32\git clone https://github.com/sawradip/gwt.git
cd gwt
go build -o gwt . && sudo mv gwt /usr/local/bin/Add this to your shell config, then restart your terminal:
Bash/Zsh (~/.bashrc or ~/.zshrc):
gwt() {
if [ "$1" = "cd" ]; then
local target_path=$(command gwt cd "$2")
if [ $? -eq 0 ] && [ -n "$target_path" ]; then
cd "$target_path"
fi
else
command gwt "$@"
fi
}Fish (~/.config/fish/config.fish):
function gwt
if test "$argv[1]" = "cd"
set target_path (command gwt cd $argv[2])
if test $status -eq 0 -a -n "$target_path"
cd "$target_path"
end
else
command gwt $argv
end
endPowerShell ($PROFILE):
function gwt {
if ($args[0] -eq "cd") {
$targetPath = & gwt.exe cd $args[1] 2>$null
if ($LASTEXITCODE -eq 0 -and $targetPath) {
Set-Location $targetPath
}
} else {
& gwt.exe @args
}
}cd ~/projects/myapp
gwt create feat/auth # Create a worktree
gwt ls # List all worktrees
gwt cd feat/auth # Switch to worktree
gwt pwd # Show current worktree
gwt cd main # Go back to main repo
gwt rm feat/auth # Remove worktree| Command | Description |
|---|---|
gwt create <branch> |
Create worktree for branch |
gwt ls |
List all worktrees |
gwt cd <name> |
Switch to worktree (or main) |
gwt pwd |
Show current worktree name |
gwt rm <name> |
Remove a worktree |
gwt prune |
Clean stale references |
gwt config |
View path pattern |
gwt config --path <pattern> |
Set path pattern |
gwt version |
Show version |
All commands support --help for detailed usage.
Control where worktrees are created. Default: ../{repo}_wt/{branch}
# View current pattern
gwt config
# Set custom pattern
gwt config --path ~/worktrees/{repo}/{branch}Placeholders:
{repo}- Repository directory name{branch}- Branch name
Examples:
| Pattern | Result for feat/auth in myapp repo |
|---|---|
../{repo}_wt/{branch} |
../myapp_wt/feat/auth |
~/worktrees/{repo}/{branch} |
~/worktrees/myapp/feat/auth |
gwt cd doesn't change directory - Add the shell function above and restart your terminal.
"Not in a git repository" - Run gwt from inside a git repo.
"Worktree already exists" - Use gwt cd <name> to switch to it.
Reset config - git config --global --unset gwt.pathpattern
See dev.md for build, test, and release instructions.
MIT
