max-sixty / worktrunk

  Worktrunk > **March 2026**: Worktrunk was released at the start of the year, and has quickly become the most popular git worktree manager. It's built with love (there's no slop!). Please let me know any frictions at all; I'm intensely focused on continuing to make Worktrunk excellent, and the biggest help is folks posting problems they perceive. 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: > ### 📚 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: , then . Worktrunk makes git worktrees as easy as branches Worktrees are addressed by branch name; paths are computed from a configurable template. > 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) > Expand into the more advanced commands as needed **Workflow automation:** • **Hooks** — run commands on create, pre-merge, post-merge, etc • **LLM commit messages** — generate commit messages from diffs • **Merge workflow** — squash, rebase, merge, clean up in one command • **Interactive picker** — browse worktrees with live diff and log previews • **Copy build caches** — skip cold starts by sharing , , etc between worktrees • ** ** — CI status and AI-generated summaries per branch • **PR checkout** — to jump straight to a PR's branch • **Dev server per worktree** — template filter gives each worktree a unique port • ...and **lots more** A demo with some advanced features: Install **Homebrew (macOS & Linux):** Shell integration allows commands to change directories. **Cargo:** Windows On Windows, defaults to Windows Terminal's command. Winget additionally installs Worktrunk as to avoid the conflict: Alternatively, disable Windows Terminal's alias (Settings → Privacy & security → For developers → App Execution Aliases → disable "Windows Terminal") to use directly. **Arch Linux:** Quick start Create a worktree for a new feature: This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with : The marks the current worktree. means staged changes, means unpushed commits. When done, either: **PR workflow** — commit, push, open a PR, merge via GitHub/GitLab, then clean up: **Local merge** — squash, rebase onto main, fast-forward merge, clean up: For parallel agents, create multiple worktrees and launch an agent in each: The flag runs a command after switching; arguments after are passed to it. Configure post-start hooks to automate setup (install deps, start dev servers). Next steps • Learn the core commands: , , , • Set up project hooks for automated setup • Explore LLM commit messages, interactive picker, Claude Code integration, CI status & PR links • Browse tips & patterns for recipes: aliases, dev servers, databases, agent handoffs, and more • Run or 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 • @DevOpsToolbox's video on Worktrunk • git-worktree documentation — Official git reference Contributing • ⭐ Star the repo • Tell a friend about Worktrunk • Open an issue — feedback, feature requests, even a small friction or imperfect user message, or a worktree pain not yet solved • Share: X · Reddit · LinkedIn > ### 📚 Full documentation at worktrunk.dev 📚 Star history