Worktrunk is a Rust CLI tool that manages Git worktrees for parallel AI agent workflows, enabling multiple worktrees with core commands like switch, list, and remove. It includes wiring for hooks, LLM commits, and per-branch workflows, with multiple installation paths and extensive documentation.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
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.
A quick demo:
📚 Full documentation at worktrunk.dev 📚
How it works
Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
Core commands include:
- Switch worktrees (wt switch)
- Create + start Claude (wt switch -c -x claude)
- Clean up (wt remove)
- List with status (wt list)
Workflow automation features include:
- Hooks to run commands on create, pre-merge, post-merge, etc
- LLM commit messages to generate commit messages from diffs
- Merge workflow to squash, rebase, merge, clean up in one command
- Interactive picker for browsing worktrees with live diff/log previews
- Copy build caches between worktrees
- Per-branch CI status and AI-generated summaries in list output
- PR checkout via wt switch pr:123
- Dev server per worktree with unique ports via hash_port template filter
- Aliases and per-branch variables for custom wt commands
Multiple parallel agents can run across worktrees using the same core commands.
Getting started
Install options:
Homebrew (macOS & Linux):
brew install worktrunk && wt config shell install
Cargo:
cargo install worktrunk && wt config shell install
Windows & other installation steps are provided under a details section in the README, including Winget and Arch Linux commands.
Quick start example:
$ wt switch --create feature-auth
✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth
Then list worktrees:
$ wt list
Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
@ feature-auth + ↑ +27 -8 ↑1 +31 4bc72dc 2h Add authenticati…
^ main ^⇡ ⇡1 0e631ad 1d Initial commit
For parallel agents, examples show launching multiple agents per worktree:
wt switch -x claude -c feature-a -- 'Add user authentication'
wt switch -x claude -c feature-b -- 'Fix the pagination bug'
wt switch -x claude -c feature-c -- 'Write tests for the API'
Getting started (continued)
Configure post-start hooks to automate setup (install deps, start dev servers).
Recent releases
Latest releases include:
- v0.71.0 0.71.0 (2026-07-30): Forge hosts are classified by exact DNS label; Host detection improved to avoid misclassification.
- v0.70.0 0.70.0 (2026-07-29):
wt step pruneremoves worktrees faster by optimizing the underlying plan generation. - v0.69.2 0.69.2 (2026-07-25):
wt removeresolves fsmonitor daemons in a single lsof call. - v0.69.1 0.69.1 (2026-07-25):
wt switchstatusline dims dev-server URL until port answers. - v0.69.0 0.69.0 (2026-07-24):
wt switchstatusline links in Claude Code.
Traction
6286 stars, 227 forks, 45 open issues as of the repository metadata.
Behind the repo
Not available in the provided data.
Caveats
License is listed as none; repository age created 2025-10-17, last push 2026-08-04. No explicit license text provided in the facts block.