gitwo is a tiny CLI that makes git worktree effortless - predictable names, safe cleanup, quick switch, and team‑friendly conventions.
# create a worktree for a ticket $ gitwo add TMS-1421 --type feature > created: ../feature/TMS-1421 > branch: feature/TMS-1421 -> origin/main # jump between sandboxes $ gitwo switch TMS-1421 > now at: ../feature/TMS-1421 # list everything (JSON or pretty) $ gitwo ls --pretty • main /repo (clean) • feature/TMS-1421 ../feature/TMS-1421 (✓) # safe cleanup $ gitwo prune --merged --dry-run would remove: ../feature/TMS-1421
Homebrew on macOS or direct binaries for Linux/Windows.
brew tap gitwohq/tap brew install gitwo
Upgrade anytime with brew upgrade gitwo.
# Linux / Windows (amd64, arm64) # Download from Releases and put on PATH chmod +x ./gitwo && sudo mv ./gitwo /usr/local/bin/
SHA256 checksums and SBOM provided with each release.
Clean folders, clear names, safer lifecycle, happier teammates.
Instant worktrees per task without extra clones or wasted GBs.
Human‑friendly add/list/switch/clean, guards against foot‑guns.
Opinionated names, ticket prefixes, and folder hygiene.
Refuses to delete dirty trees; dry‑run previews before removal.
Create from any ref, track upstream, jump back with zero context loss.
Scriptable JSON output + exit codes for hooks, bots, and CI checks.
Work like every task has its own repo—without the clones.
git worktree?gitwo wraps the sharp edges: consistent naming, safe cleanup, quick switch, ticket awareness, and helpful guards. It’s the ergonomics teams re‑invent in ad‑hoc scripts—baked in and documented.
No magic. gitwo is a thin CLI on top of Git. It creates/removes worktrees and branches using official plumbing.
Yes. Single static Go binary: Homebrew on macOS; archives for Linux/Windows. Works anywhere Git works.
Configure prefixes (feature/, bugfix/, chore/), ticket extractors (Jira/Linear), and folder templates in a dotfile.