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
/worktreeskill - 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.