AgentMux orchestrates a deterministic multi-agent workflow for end-to-end software development. It drives the AI CLIs you already use — Claude, Codex, Copilot, Cursor, Gemini, OpenCode, Qwen — through tmux, reusing your existing subscriptions instead of paying per token.
A deterministic state machine moves work through product_management → architecting → planning → designing → implementing → reviewing → completing. Every transition is driven by structured events, never by artifact sniffing.
Each phase hands off through MCP-validated contracts — no freeform drift between architect, planner, coder, and reviewer.
No bespoke runtime, no proprietary harness. AgentMux drives the existing CLIs you already authenticated against — claude, codex, copilot, cursor, gemini, opencode, qwen — through tmux key injection, reusing your subscriptions.
The reviewing phase fans out into logic, quality, and expert reviewers. A single pass/fail verdict either promotes the work to completing or sends it back through fixing — bounded by an explicit loop cap.
From zero to a tmux session driving multiple AI CLIs in under three minutes.
Pull the AgentMux CLI as an isolated tool with pipx. It exposes the agentmux command everywhere.
pipx install git+https://github.com/markuswondrak/AgentMux.gitScaffold the .agentmux/ directory in your repo. The interactive wizard configures providers per role.
cd your-repo && agentmux initHand AgentMux a feature description. It opens a tmux session and drives the workflow end-to-end.
agentmux "Add rate limiting to the API"Existing CLI agents (claude, codex, copilot, cursor, gemini, opencode, qwen) are driven by keystroke events injected into tmux panes. Agents never talk to each other — the orchestrator mediates exclusively through the file system and a shared event bus. The blue line marks the closed event loop.
CLI entry, launcher, --orchestrate mode.
Four layers: defaults → user → project → CLI.
Creates & resumes feature sessions. state.json holds the phase.
Routes events to phase handlers, drives the state machine, builds prompts lazily and dispatches them to the right pane.
Research dispatch and submit tools. Writes tool events to jsonl.
architecting · planning · designing · implementing · reviewing (∥) · fixing · completing
Pane lifecycle. send_prompt() injects "Read /path/prompt.md".
ANSI status rendering for the control pane.
Monitor pane left, agent panes right. Each pane hosts a CLI: claude · codex · copilot · cursor · gemini · opencode · qwen.
Run the architect on Claude Max, the coder on Codex, the reviewer on Gemini — each role independently configurable in .agentmux/config.yaml.
AgentMux is open source on GitHub. Install it with pipx, point it at a repo, and drive your existing CLI subscriptions through a structured multi-agent workflow.