Worktrunk
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:
Context: git worktrees
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.
Worktrunk makes git worktrees as easy as branches
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:
Install
Homebrew (macOS & Linux):
&&
Shell integration allows commands to change directories.
Cargo:
&&
Next steps
- 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
Further reading
- 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