worktrunk

Open source alternative to Conductor, Graphite and GitKraken

9.3K stars
MIT OR Apache-2.0
Active this week
Last commit 3 days ago

Last verified Oct 19, 2026

Manage Git worktrees for parallel AI agent workflows with three simple commands that replace verbose git worktree syntax.

Visit website GitHub9.3K

Read the full breakdownWho it is for, how it works, trade-offs, the quick start and the FAQ

who it's for

Who worktrunk is for#

Developers running parallel AI coding agents

Worktrunk is designed for this workflow. Running `wt switch -x claude -c feature-a`, `wt switch -x claude -c feature-b`, and `wt switch -x claude -c feature-c` in sequence launches three Claude Code sessions in three isolated worktrees, each on its own branch. Hooks handle per-worktree dependency installs and dev server setup automatically.

Skip if:

You run only one AI agent at a time or all your agent work fits on a single branch. The single-agent case gains nothing over a standard checkout.

Teams reviewing multiple open PRs simultaneously

`wt switch pr:123` checks out a PR's branch in a new worktree without disturbing the main checkout or any other in-progress work. Reviewers can run the PR's code locally and switch between several PRs in the same session using the interactive picker, then remove each worktree when done.

Skip if:

Your review process does not require running the code locally. If reading diffs in GitHub is sufficient, a checkout tool adds no value.

Engineers who maintain multiple long-running feature branches

Worktrunk's `wt list` shows staged changes, ahead/behind counts, CI status, and LLM-generated summaries for every active worktree in one view. Engineers juggling a hotfix, a feature, and a dependency upgrade can see the state of all three branches at a glance and switch between them without stashing.

Skip if:

Your team uses short-lived branches merged within a day or two. The benefits of parallel worktrees scale with branch lifespan and count.

Platform teams standardizing AI agent workflows

Hooks and aliases let platform teams encode standard worktree setup (install deps, start the right dev server, run migrations) into shared config that every engineer on the team gets. New agents inherit the same environment automatically, which reduces per-agent setup friction and onboarding time.

Skip if:

Your team does not use AI agents for development or manages agent environments through a different mechanism such as a container-per-task setup.

the problem

The problem it solves#

Running multiple AI coding agents in parallel requires each agent to have its own working directory so they do not overwrite each other's changes. Git's worktree feature provides exactly that isolation, but the command interface was not designed for frequent, rapid use. Creating a worktree means typing the branch name three times across a two-command sequence; switching between worktrees means changing directories by path; cleaning up requires three separate git and shell commands in the right order.

At the scale of 5-10 concurrent agents, this friction adds up. Every new task needs a worktree created and an agent launched inside it. Every finished task needs the worktree removed, the branch deleted, and the terminal returned to the main checkout. Teams working this way end up writing shell aliases or wrapper scripts to manage what should be a first-class workflow. Worktrunk replaces those workarounds with a stable, tested CLI designed specifically for this use case.

how worktrunk solves it

How it solves it#

Branch-addressed worktrees

Worktrees are identified by branch name rather than filesystem path. Worktrunk computes the path from a configurable template, so `wt switch feat` navigates to the right directory without the caller knowing or typing the path. Commands that accept a branch name also accept the worktree's path, so either form works.

One-command agent launch

The `-x` flag runs a command after switching to a worktree and `-c` creates the branch if it does not exist. `wt switch -x claude -c feature-a` creates the branch, creates the worktree, switches to it, and starts Claude inside it in a single command. Any prompt or extra arguments for the launched command are passed directly after the command name. The equivalent plain-git sequence takes four steps.

Lifecycle hooks

Hooks run shell commands at defined points: on worktree create, pre-merge, post-merge, and others. Common uses include installing dependencies, starting a dev server tied to the worktree, or running a database migration on branch switch. Hooks are configured per-repo and stored alongside the project.

LLM commit messages

Worktrunk can generate commit messages from the staged diff using a configured LLM. `wt step commit` stages, generates a message, and commits in one step. The merge workflow (`wt merge main`) does the same automatically before squashing and fast-forward merging to the target branch.

Interactive worktree picker

Running `wt switch` without arguments opens an interactive picker that shows all worktrees with live diff previews and recent log entries. The picker lets you browse and jump to any worktree without remembering branch names, which is useful when managing eight or more concurrent agents.

Shared build caches

On filesystems that support reflinks (APFS, btrfs, XFS), Worktrunk can copy build artifact directories such as `target/` or `node_modules/` between worktrees using filesystem-level copy-on-write. Ten worktrees share one build cache instead of building independently, which cuts setup time when spawning new agent worktrees.

strengths · trade-offs

Strengths and trade-offs#

Strengths

Dual MIT/Apache-2.0 licenseWorktrunk is released under MIT OR Apache-2.0 at the user's choice. Both licenses permit commercial use, internal tooling, and redistribution without licensing fees or attribution requirements beyond standard copyright notices. Teams that standardize on Apache-2.0 for its patent grant can pick that; teams that prefer MIT simplicity can pick that instead.
Full lifecycle in four commandsSwitch (create + navigate), list (with status, CI state, and LLM summaries), merge (squash, rebase, fast-forward, and clean up in one command), and remove cover the complete worktree workflow. The four commands compose with hooks and the `-x` flag to handle any variant without needing custom shell scripts.
Active development with 7,000+ starsReleased in early 2026, Worktrunk reached 7,239 GitHub stars by September 2026 and had a commit pushed on 2026-09-12. The project has 39 open issues, which at its star count suggests active community engagement rather than abandonment. The author has publicly stated a focus on reducing any friction in the worktree workflow.
Cross-platform installWorktrunk installs via Homebrew (macOS and Linux), Cargo (Rust toolchain required), Winget (Windows, where it installs as `git-wt` to avoid a name conflict with Windows Terminal), pacman (Arch Linux), and Conda or Pixi (community-maintained feedstock). Windows binary signing is provided by SignPath Foundation.

Trade-offs

-Rust toolchain required for Cargo install pathInstalling via `cargo install worktrunk` requires a working Rust toolchain. Teams without Rust installed should use Homebrew or another binary package manager instead. The Homebrew and pacman paths install pre-built binaries with no Rust dependency.
-Shell integration needed for directory switchingWorktrunk's ability to change the terminal's working directory requires a shell integration step (`wt config shell install`) that modifies the shell config file. Without it, `wt switch` opens a subshell rather than changing the current shell's directory. The install step is documented and one command, but it is an extra setup requirement on first use.
-No GUI or IDE pluginWorktrunk is a CLI tool with no graphical interface and no VS Code or JetBrains plugin. Teams that manage Git through IDE UIs rather than the terminal will not be able to use Worktrunk's core features from within their editor. The interactive picker runs in the terminal, not inside an IDE panel.

versus alternatives

worktrunk vs alternatives#

Worktrunk vs Plain Git Worktree Commands

Git's built-in git worktree command provides the underlying isolation that Worktrunk builds on. The question for any team is whether the wrapper's added UX is worth the dependency.

Task	Worktrunk	Plain git
Create + switch	`wt switch -c feat`	`git worktree add -b feat ../repo.feat && cd ../repo.feat`
Create + launch Claude	`wt switch -c -x claude feat`	`git worktree add -b feat ../repo.feat && cd ../repo.feat && claude`
List with status	`wt list`	`git worktree list` (paths only, no status)
Remove	`wt remove`	`cd ../repo && git worktree remove ../repo.feat && git branch -d feat`
Merge + clean up	`wt merge main`	Separate rebase, merge, worktree remove, branch delete

For teams running one or two worktrees occasionally, the native git commands are sufficient. Worktrunk's value increases with worktree count: at five or more concurrent agents, the branch-addressed UX, lifecycle hooks, and the interactive picker each save meaningful time per session. The merge workflow (wt merge main) alone eliminates four to five manual steps that are easy to do out of order.

The main cost of choosing Worktrunk over plain git is adding a dependency. If your team runs on machines where Homebrew or Cargo is already available, that cost is low. If you manage locked-down developer environments, you need to add Worktrunk to your provisioning scripts.

Worktrunk vs IDE Git GUI Tools

IDE Git integrations (VS Code Source Control, JetBrains Git, Tower, Fork) provide graphical worktree management on some versions, but none integrate the agent-launch step (-x claude), lifecycle hooks, or shared build caches that define Worktrunk's workflow. If your team manages all Git operations through an IDE and does not run AI agents, a GUI tool may be sufficient. Worktrunk is the better fit when the terminal is already your primary interface and AI agent orchestration is the goal.

install · quick start

Quick start#

bash

Install via Homebrew on macOS or Linux, then run the shell integration setup.
```bash
brew install worktrunk && wt config shell install
```
Or install from source with Cargo:
```bash
cargo install worktrunk && wt config shell install
```

tech stack · detected from GitHub

What it's built on#

Languages: Rust

frequently asked

FAQ#

Does Worktrunk replace git worktree commands entirely?

Worktrunk wraps Git's native worktree feature rather than replacing it. It calls git worktree under the hood and stores its own metadata alongside the repo. You can still use plain git worktree commands alongside Worktrunk; the two are compatible. Worktrunk adds the branch-addressed UX, hooks, the interactive picker, and the merge workflow on top of what Git already provides.

Is Worktrunk free for commercial use?

Yes. Worktrunk is dual-licensed MIT OR Apache-2.0. Both licenses permit commercial use, including internal business tooling and redistribution. The Apache-2.0 option requires attribution notices and modified-file notices when redistributing; the MIT option requires the copyright notice be included in copies. There is no paid tier or usage limit.

What shells does Worktrunk support for its shell integration?

The README lists bash, zsh, fish, nushell, and PowerShell (pwsh) as tested shells. The shell integration (wt config shell install) adds a function to your shell config so that wt switch changes the current shell's directory instead of opening a subshell. Without this step the tool still works, but directory switching requires a subshell.

How does Worktrunk handle the Windows Terminal name conflict with `wt`?

On Windows, wt is the default alias for Windows Terminal, which conflicts with Worktrunk's command. The Winget package installs Worktrunk as git-wt to avoid the conflict. Alternatively, you can disable Windows Terminal's app execution alias in Settings and use wt directly. The Windows binary is signed by SignPath Foundation.

Can Worktrunk share node_modules or build artifacts between worktrees?

Yes, on filesystems that support reflinks. On APFS (macOS), btrfs, and XFS, wt step copy-ignored copies directories like node_modules/ or target/ between worktrees using copy-on-write, so each worktree gets its own copy that only stores diffs from the source. This avoids running a full install or build in each new worktree. The feature requires a supported filesystem and does not work on ext4 or NTFS.

also worth a look

Similar open-source tools#

paperclip

Featured

Alternative toGrok Bot

Self-hosted AI agent management with org charts and budgets

105,118 GitHub stars
Licence MIT

Threadlines

Alternative toConductor

Open-source ADE for Claude Code, Codex, and Cursor in one thread

20 GitHub stars
Licence MIT

Orgtree

Alternative toConductor

Desktop canvas for persistent multi-agent AI teams, Windows-only

168 GitHub stars
Licence MIT

Herdr

Alternative toConductor

Agent runtime that keeps terminals alive across machines

44,852 GitHub stars
Licence Apache-2.0

5dive

Alternative toConductor

Run a company of AI agents on a server you own.

73 GitHub stars
Licence MIT

Hypa

Alternative toConductor

Local-first terminal workspace for AI coding agents

212 GitHub stars
Licence FSL-1.1-ALv2

by category

Open source tools in these categories#

463

12,712 GitHub stars
Licence AGPL-3.0
#Email

rakazo

Alternative toGrok Bot

AI teammates you own: your keys, your model, your machine.

4,904 GitHub stars
Licence Apache-2.0
#AI Agents

Omnara

Alternative toClaude Managed Agents

Open-source agent deployment API. Self-host or use Omnara Cloud.

2,957 GitHub stars
Licence Apache-2.0
#AI Agents

Feature your project

The projects we add and every new guide. Free, unsubscribe any time.

Find open source alternatives to paid software

Worktrunk vs Plain Git Worktree Commands

Git's built-in git worktree command provides the underlying isolation that Worktrunk builds on. The question for any team is whether the wrapper's added UX is worth the dependency.

Task	Worktrunk	Plain git
Create + switch	`wt switch -c feat`	`git worktree add -b feat ../repo.feat && cd ../repo.feat`
Create + launch Claude	`wt switch -c -x claude feat`	`git worktree add -b feat ../repo.feat && cd ../repo.feat && claude`
List with status	`wt list`	`git worktree list` (paths only, no status)
Remove	`wt remove`	`cd ../repo && git worktree remove ../repo.feat && git branch -d feat`
Merge + clean up	`wt merge main`	Separate rebase, merge, worktree remove, branch delete

Who worktrunk is for#

Developers running parallel AI coding agents

Skip if:

Teams reviewing multiple open PRs simultaneously

Skip if:

Engineers who maintain multiple long-running feature branches

Skip if:

Platform teams standardizing AI agent workflows

Skip if:

The problem it solves#

How it solves it#

Branch-addressed worktrees

One-command agent launch

Lifecycle hooks

LLM commit messages

Interactive worktree picker

Shared build caches

Strengths and trade-offs#

Strengths

Trade-offs

worktrunk vs alternatives#

Worktrunk vs Plain Git Worktree Commands

Worktrunk vs IDE Git GUI Tools

Quick start#

What it's built on#

FAQ#

Similar open-source tools#

Open source tools in these categories#

Developer Tools

AI & Machine Learning

DevOps & CI/CD

Find open source alternatives to paid software

Who worktrunk is for#

Developers running parallel AI coding agents

Skip if:

Teams reviewing multiple open PRs simultaneously

Skip if:

Engineers who maintain multiple long-running feature branches

Skip if:

Platform teams standardizing AI agent workflows

Skip if:

The problem it solves#

How it solves it#

Branch-addressed worktrees

One-command agent launch

Lifecycle hooks

LLM commit messages

Interactive worktree picker

Shared build caches

Strengths and trade-offs#

Strengths

Trade-offs

worktrunk vs alternatives#

Worktrunk vs Plain Git Worktree Commands

Worktrunk vs IDE Git GUI Tools

Quick start#

What it's built on#

FAQ#

Similar open-source tools#

Open source tools in these categories#

Developer Tools

AI & Machine Learning

DevOps & CI/CD

Find open source alternatives to paid software