Stop. Read this first.
In the words of Steve Yegge and his warning of Gas Town (paraphrasing)...
DON'T INSTALL THIS SOFTWARE!
This is in active development and has many bugs and sharp edges.
Yegge's exact wording is "'You probably don't want to use it yet.' It needs some Lysol." and "You shouldn't be using it now, unless you're either experimenting or you're contributing. Otherwise it's too much of a headache."
Now that we've gotten that out of the way. Welcome to my in-progress cmux orchestrator.
A web-based orchestrator for managing parallel Claude Code sessions across cmux workspaces. Define high-level objectives, and the orchestrator breaks them into tasks, spins up agents, dispatches work across workspaces, and tracks everything from a single browser tab.
- cmux — installed and running, with Automation mode enabled:
- Open cmux > Settings > Automation
- Enable the socket API (this exposes the v2 JSON-RPC API that the orchestrator talks to)
- Python 3.9+ — no pip install, no virtual env, no dependencies. Standard library only.
- Claude Code — installed and authenticated (
claudemust be in your PATH)
git clone [email protected]:ronnie3786/cmux-orchestrator.git
cd cmux-orchestrator
# Start the orchestrator
python3 dashboard.pyOpens automatically at http://localhost:9091. Custom port: python3 dashboard.py 8080
The core of the app. Define objectives in plain language and the orchestrator handles the rest.
- Objective-driven workflow — describe what you want built, and the system uses Claude to decompose it into discrete tasks with dependencies
- Multi-workspace dispatch — tasks are assigned to available cmux workspaces and executed in parallel across independent Claude Code sessions
- Live progress tracking — real-time status for every task (queued, in progress, completed, failed) with a unified view across all workspaces
- Sprint contracts — define acceptance criteria and the orchestrator evaluates task output against them before marking work complete
- Dependency-aware scheduling — tasks execute in the right order; dependent tasks wait for their prerequisites to finish
Single-page web app — no build step, no npm, no framework.
- Project sidebar — organize objectives by project, with progress bars and status indicators
- Streaming conversation — watch the orchestrator plan, dispatch, and report in real time
- Plan and contract review — review the orchestrator's plan and acceptance criteria before execution starts
- Approval workflow — tasks below your severity threshold auto-approve; higher-severity actions escalate to you with approve/take-over options
- Git panel — branch, commits, staged/unstaged changes for the active objective's working directory
- Diff viewer — inspect code changes inline as tasks complete
- Build log viewer — view build output and errors for the active objective
- Console log viewer — stream Claude Code console output with filtering presets
All settings are configurable from the dashboard UI and persist across restarts.
MIT