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.
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 won't 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 reinstall everything"
New worktrees are clean checkouts with no .env, no node_modules, no dev server. workmux can copy config files, symlink dependencies, and run setup commands on creation.
"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 don't 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.
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.
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.
"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