workmux

Parallel development in tmux* with git worktrees

📖 Documentation · Install · Quick start · Commands · Changelog

---

Giga opinionated zero-friction workflow tool for managing git worktrees and tmux windows as isolated development environments. Perfect for running multiple AI agents in parallel without conflict.

Philosophy: Build on tools you already use. tmux/zellij/kitty/etc. for windowing, git for worktrees, your agent for coding — workmux orchestrates the rest.

^{_{* Also supports kitty, WezTerm, and Zellij as alternative backends.}}

📚 See the full documentation for guides and configuration reference.

📖 New to workmux? Read the introduction blog post for a quick overview.

Why workmux?

Parallel workflows. Work on multiple features the same time, each with its own AI agent. No stashing, no branch switching, no conflicts.

One window per task. A natural mental model. Each has its own terminal state, editor session, dev server, and AI agent. Context switching is switching tabs.

Automated setup. New worktrees start broken (no .env, no node_modules, no dev server). workmux can copy config files, symlink dependencies, and run install commands on creation.

One-command cleanup. workmux merge handles the full lifecycle: merge the branch, delete the worktree, close the tmux window, remove the local branch.

Terminal workflow. Build on your terminal setup instead of yet another agentic GUI that won't exist next year. If you don't have one yet, tmux might be worth picking up.

New to worktrees? See Why git worktrees?

Features

• Create git worktrees with matching tmux windows in a single command (add)
• Merge branches and clean up everything (worktree, tmux window, branches) in one command (merge)
• Dashboard for monitoring agents, reviewing changes, and sending commands
• Sidebar for a persistent, at-a-glance view of all agents across tmux windows
• Delegate tasks to worktree agents with the /worktree skill
• Display agent status in tmux window names
• Automatically set up your preferred tmux pane layout (editor, shell, watchers, etc.)
• Run post-creation hooks (install dependencies, setup database, etc.)
• Copy or symlink configuration files (.env, node_modules) into new worktrees
• Sandbox agents in containers or VMs for enhanced security
• Automatic branch name generation from prompts using LLM
• Shell completions

Hype

"I've been using (and loving) workmux which brings together tmux, git worktrees, and CLI agents into an opinionated workflow."
— @Coolin96 🔗

"Thank you so much for your work with workmux! It's a tool I've been wanting to exist for a long time."
— @rstacruz 🔗

"It's become my daily driver - the perfect level of abstraction over tmux + git, without getting in the way or obscuring the underlying tooling."
— @cisaacstern 🔗

"I have to mention workmux at every opportunity because it's the perfect glue between worktrees, agents and tmux windows."
— @dedbrizz 🔗

Installation

Bash YOLO

curl -fsSL https://raw.githubusercontent.com/raine/workmux/main/scripts/install.sh | bash

Homebrew (macOS/Linux)

brew install raine/workmux/workmux

Cargo

Requires Rust. Install via rustup if you don't have it.

cargo install workmux

Nix

nix profile install github:raine/workmux
# or try without installing
nix run github:raine/workmux -- --help

See Nix guide for flake and home-manager setup.

---

For manual installation, see pre-built binaries.

Quick start