Skip to content

max-sixty/worktrunk

Repository files navigation

Worktrunk logo  Worktrunk

Docs Crates.io License: MIT CI Codecov

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:

Worktrunk 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'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

A demo with some advanced features:

Worktrunk omnibus demo: multiple Claude agents in Zellij tabs with hooks, LLM commits, and merge workflow

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

Further reading

Contributing

πŸ“š Full documentation at worktrunk.dev πŸ“š

About

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Topics

Resources

License

Stars

Watchers

Forks

Languages