Installation

From source

cargo install --path crates/gwt

Prerequisites

• Git — gwt manages git worktrees
• Zellij — terminal multiplexer for session management (install)
• Node.js (optional) — required for Diffity code review integration

Shell alias conflict

If you use oh-my-zsh, its git plugin defines gwt as an alias for git worktree. Add this to your .zshrc after the source $ZSH/oh-my-zsh.sh line:

unalias gwt 2>/dev/null

Shell completions

Install tab completions for your shell:

gwt completions install

Verify installation

Run gwt doctor to check that everything is set up correctly:

gwt doctor

  ✓ git repo (/path/to/project)
  ✓ branch (main)
  ✓ zellij (0.42.1)
  ✓ gwt.toml (found)
  ✓ worktrees (3 found in .worktrees)
  ✓ gateway apps (2 configured)
  ✓ diffity (ready)