CLI

August 14, 2026 ยท View on GitHub

gwm <subcommand> is the scriptable side of gwm, designed to be safe in pipelines, shell completions, and pre-commit hooks. Every subcommand exits with a meaningful code (0 ok, 1 warning, 2 failure) so you can wire gwm doctor into CI without parsing stdout.

  • Reference: every subcommand, exhaustive (init, config, create, new, pr, review, list, path, cd, switch, bootstrap, sync, remove, prune, exec, clean, undo, history, link, unlink, open, status, labels, milestones, doctor, daemon, statusline, trust, types, commit-prefix, hooks, theme, tui keys, aliases, tmux, zellij, completions, shell-init).
  • Shell completions: generate completion scripts for zsh / bash / fish / PowerShell / elvish, plus dynamic worktree-name completion via gwm list --format=names.
  • Multiplexer integration: gwm tmux / gwm zellij to open a worktree in a new tab or pane of the current session.

The CLI never spawns a TUI of its own: every subcommand is non-interactive and prints to stdout/stderr. The only TUI surface is bare gwm (or gwm switch in picker mode), covered in the TUI section.