↓ Skip to main content
tomrochette.com
  1. Agents/

Worktrunk

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 4 minutes read (~680 words)
agent-curated 173 cli 8 fully-ai-generated 263 git-worktrees 9 llm=glm-5.3-flash 178 open-source 62 orchestration 16 research-note 148
Table of Contents

Worktrunk (wt) is a Rust CLI that makes git worktrees as easy as branches so you can run many coding agents in parallel, with lifecycle hooks, LLM commit messages, and a one-command merge pipeline. Facts below verified as of 2026-09-13.

Worktrunk wins by staying out of the way: no TUI to learn, no daemon to run, just worktrees addressed by branch name plus hooks that automate the boring 80 percent of the parallel-agent workflow.

What it is
#

A single native binary around five verbs: wt switch (create a branch, worktree, and launch an agent in one command, -x claude -c feature-a -- 'prompt'), wt list (a status table with staged files, ahead/behind, CI status, and LLM summaries), wt merge (squash, rebase, fast-forward, and clean up in one pipeline), wt remove, and wt config. Ten hook types (pre/post across switch, start, commit, merge, remove) are defined in a project .config/wt.toml or your user config, with pre-hooks blocking on failure and post-hooks running in background; a first-run approval prompt guards project hooks. Extras include pr:123 checkout, an interactive picker with diff previews, cache sharing between worktrees for node_modules-style directories, and LLM-generated commit messages. Dual MIT or Apache-2.0 license, Homebrew, cargo, winget, and Arch (pacman) distribution, by Maximilian Roos as the dominant maintainer.

Status
#

The leading worktree manager of the agent wave: about 7.3k stars, 258 forks, 40 open issues and PRs as of 2026-09-13, created 2025-10-17, more than 5,000 commits on main, latest release v0.77.0 on 2026-09-08. Roughly 77 releases in ten and a half months; still pre-1.0 with breaking changes per release, and effectively a single-maintainer project.

Strengths
#

  • Purpose-built loop for parallel agents: the -x flag plus hooks covers dev servers, dependency installs, and per-worktree databases, not just worktree creation.
  • Exceptional documentation, including agent-integration guides, and a status surface (wt list) that answers what all my agents are doing at a glance.
  • Polished cross-platform distribution with signed Windows binaries and an answer to the Windows Terminal wt collision (git-wt).
  • Fast cadence with community bug reports fixed within days.

Cautions
#

  • Bus factor approximately one: nearly all human commits are from the maintainer.
  • Pre-1.0 churn is real; v0.75 raised the git minimum and broke both the list JSON schema and the library API, and v0.76 changed -x from a shell string to a single program name.
  • Hooks execute arbitrary shell from project config; the approval system mitigates it, but review .config/wt.toml in unfamiliar repos.
  • No independent critical review exists yet, and the tool assumes you are comfortable in your own shell and editor.

Pricing
#

Free and open source, dual MIT or Apache-2.0, no paid tiers and no hosted component.

Compared to
#

  • Claude Squad: a TUI that hosts agents inside tmux with a review surface; choose it for one app that supervises agents, Worktrunk to keep your own shell and editor with hooks automating the lifecycle.
  • dmux: a tmux pane per task with AI-named worktrees; choose it for an opinionated tmux flow, Worktrunk for a lighter native binary and deeper git plumbing.
  • Plain git worktree: zero dependencies and fully standard; fine for occasional use, Worktrunk pays off once you juggle several agents and branches at once.

Bottom line
#

Recommended for terminal-first engineers running two or more parallel agents in one repo who want the worktree lifecycle automated without adopting a dashboard. Not for GUI-first workflows, and not for anyone who needs a project to promise stability before 1.0.

Changes
#

  • 2026-08-30 - Created as an Orchestration note with the single-maintainer risk flagged.
  • 2026-09-02 - Recorded the v0.76.0 release with its breaking -x flag change.

See also
#

References
#