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:

Worktrunk demo showing wt list, wt switch, and wt merge — Listing worktrees, creating a worktree, working, merging back

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

Worktrunk

Context: git worktrees

Worktrunk makes git worktrees simple

Install

Next steps

Further reading