Skip to content
workmux

Terminal-first workflow for parallel AI agents.

Turn your terminal into a multi-agent workspace. Every task gets a dedicated git worktree and tmux window, letting agents code conflict-free.

workmux in action with multiple AI agents working across tmux windows

Parallel workflows

Work on features side by side. No stashing, no branch switching, no conflicts.

One window per task

A natural mental model. Each has its own terminal state, editor session, and dev server. Context switching is switching tabs.

Terminal workflow

Build on your familiar terminal setup instead of yet another agentic GUI that will not exist next year. Your tools, your muscle memory.

Git worktrees are powerful, but managing them manually is painful. workmux automates the rough edges.

"You need to clean up after"

workmux merge handles the full lifecycle: merge the branch, delete the worktree, close the tmux window, remove the local branch. One command. Or go next level and use the /merge skill to let your agent commit, rebase, and merge autonomously.

"Conflicts arise on merge"

Conflicts are inherent to git when changes overlap, and worktrees do not change that. But your agent can handle them. The /merge skill tells your agent to rebase onto the base branch, review the upstream changes, and resolve conflicts by understanding both sides. No manual conflict resolution needed in most cases. See finishing work.

Spin up worktrees, develop in parallel, merge and clean up.

Silent demonstration of workmux creating, switching between, and merging parallel worktrees.

Run agents in YOLO mode.

Enable sandboxing to run agents in isolated containers or Lima VMs scoped to the worktree. Host keys, creds, and files stay isolated while agents operate inside the worktree.

Learn more →

A tmux popup dashboard to track progress across all agents.

workmux dashboard tracking multiple AI agents

From a single command to agent orchestration skills.

Solo

workmux add -A "Add cursor-based pagination to /api/users"

One command creates a branch, worktree, and starts an agent with your prompt in a new tab.

Delegated

/worktree Implement the caching layer

From inside an agent, spin off a subtask to a new worktree with full context.

Coordinated

/coordinator Break down the auth refactor into parallel tasks

One agent spawns, monitors, and merges multiple worktree agents.

Learn more →
"I've been using (and loving) workmux which brings together tmux, git worktrees, and CLI agents into an opinionated workflow."
- @Coolin96 via Hacker News
"Thank you so much for your work with workmux! It's a tool I've been wanting to exist for a long time."
- @rstacruz via GitHub
"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 via GitHub
"I have to mention workmux at every opportunity because it's the perfect glue between worktrees, agents and tmux windows."
- @dedbrizz via Threads
"Since I discovered workmux I'm cooking. Amazing parallel-agent driver if you like tmux and want to keep your config."
- @MatijaSosic via X
"Using workmux with a well-configured tmux has been a breath of fresh air"
- @sbeirakh_il via X
"I've been using it for about a month now, and it's been nothing but great."
- @gabrielrockson_ via X
"I still don't see the need for Herdr. Workmux adds busy/question/done status, manages worktrees by itself, and etc. It lives on an already existing tmux setup."
- @13hcoks via X
"Want modern terminal workspace features without abandoning your setup? Here is how to keep Tmux and boost your workflow using Workmux."
- Sam Natale via YouTube

Start using workmux