December 2025: I've been using Worktrunk as my daily driver, and am releasing it as Open Source this week; I think folks will find it really helpful. It's built with love (there's no slop!). If social proof is helpful: I also created PRQL (10k stars) and am a maintainer of Xarray (4k stars), Insta, & Numbagg.
Worktrunk is a CLI for git worktree management, designed for running AI agents in parallel.
Worktrunk's three core commands make worktrees as easy as branches. Plus, Worktrunk has a bunch of quality-of-life features to simplify working with many parallel changes, including hooks to automate local workflows.
Scaling agents becomes trivial. A quick demo:
π Full documentation at worktrunk.dev π
AI agents like Claude Code and Codex can handle longer tasks without supervision, such that it's possible to manage 5-10+ in parallel. Git's native worktree feature give each agent its own working directory, so they don't step on each other's changes.
But the git worktree UX is clunky. Even a task as small as starting a new
worktree requires typing the branch name three times: git worktree add -b feat ../repo.feat, then cd ../repo.feat.
Each worktree has exactly one branch, so Worktrunk uses branch names to address worktrees. The path is derived automatically.
Start with the core commands
Core commands:
| Task | Worktrunk | Plain git |
|---|---|---|
| Switch worktrees | wt switch feat |
cd ../repo.feat |
| Create + start Claude | wt switch -c -x claude feat |
git worktree add -b feat ../repo.feat && \ cd ../repo.feat && \ claude |
| Clean up | wt remove |
cd ../repo && \ git worktree remove ../repo.feat && \ git branch -d feat |
| List with status | wt list |
git worktree list(paths only) |
Workflow automation:
Expand into the more advanced commands as needed
- Hooks β run commands on create, pre-merge, post-merge, etc
- LLM commit messages β generate commit messages from diffs via llm
- Merge workflow β squash, rebase, merge, clean up in one command
- ...and lots more
A demo with some advanced features:
Homebrew (macOS & Linux):
$ brew install max-sixty/worktrunk/wt && wt config shell installShell integration allows commands to change directories.
Cargo:
$ cargo install worktrunk && wt config shell install- Learn the core commands: wt switch, wt list, wt merge, wt remove
- Set up project hooks for automated setup
- Explore LLM commit messages, fzf-like selector, Claude Code integration, CI status & PR links
- Run
wt --helporwt <command> --helpfor quick CLI reference
- Claude Code: Best practices for agentic coding β Anthropic's official guide, including the worktree pattern
- Shipping faster with Claude Code and Git Worktrees β incident.io's workflow for parallel agents
- Git worktree pattern discussion β Community discussion in the Claude Code repo
- git-worktree documentation β Official git reference
- β Star the repo
- Open an issue β feedback, feature requests, even a small friction or imperfect user message, or a worktree pain not yet solved
- Share: X Β· Reddit Β· LinkedIn
π Full documentation at worktrunk.dev π


