Worktrunk

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 parallel AI agent workflows. Git worktrees give each agent an isolated branch and directory; Worktrunk wraps them in a clean interface, plus extension points. Scaling agents becomes as simple as scaling git branches.

Here's a quick demo:

📚 Full documentation at worktrunk.dev 📚

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 worktrees give each agent its own working directory; no stepping on each other's changes.

But the git worktree UX is clunky. Even a task as simple 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 simple

Start with the core commands; add workflow automation as needed.

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:

• Lifecycle hooks — run commands on create, pre-merge, post-merge
• LLM commit messages — generate commit messages from diffs via llm
• Merge workflow — squash, rebase, merge, clean up in one command
• ...and lots more

Install

Homebrew (macOS & Linux):

$ brew install max-sixty/worktrunk/wt
$ wt config shell install

Shell integration allows commands to change directories.

Cargo:

$ cargo install worktrunk
$ wt config shell install

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 --help or wt <command> --help for 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

Contributing

• ⭐ Star the repo
• Open an issue — feedback, feature requests, or a worktree friction we don't yet solve
• Share: X · Reddit · LinkedIn

📚 Full documentation at worktrunk.dev 📚