npx claudepluginhub hummer98/cmux-teamMulti-agent development orchestration with Claude Code + cmux. Spawn, monitor, and integrate parallel sub-agents visually in terminal panes.
hummer98
Multi-agent development orchestration with Claude Code + cmux.
Claude Code's built-in sub-agents (the Agent tool) are useful, but you can't see what they're doing. You only get the final result — the process is a black box.
cmux-team uses cmux's terminal splitting to run sub-agents visibly in parallel.
What you do: Just give Claude instructions in natural language. What Claude does: Splits panes via cmux, launches sub-agents, monitors them, and integrates results.
brew install --cask font-hack-nerd-font
CMUX_NERD_FONT=0 to use fallback icons explicitly.npm install -g @hummer98/cmux-team
Start cmux, launch Claude Code inside it.
You: /cmux-team:start
→ Daemon starts with TUI dashboard
→ Master pane auto-created
→ Switch to Master pane to give tasks
You: Build a TODO app with React
Claude: Task created.
→ Daemon detects task → spawns Conductor
→ Conductor spawns Agents in adjacent panes
→ Watch each agent working in real time
You: How's it going?
Claude: (checks manager.log, cmux tree)
Conductor-1: implementing (2/3 agents done)
You: Also clean up worktrees (TODO)
Claude: → Sends TODO to queue via CLI
→ Daemon spawns new Conductor in parallel
| Command | What it does | When to use |
|---|---|---|
cmux-team start | Start daemon + Master + Conductors | Once per session |
cmux-team status | Show team status | Anytime |
cmux-team stop | Graceful shutdown | When done |
cmux-team create-task | Create a task | Task creation |
cmux-team trace | Search API traces | Debugging, analysis |
cmux-team artifacts | List / show / search artifacts | Knowledge management |
| Command | What it does | When to use |
|---|---|---|
/cmux-team:master | Reload Master role | After /clear |
/team-spec [summary] | Brainstorm requirements | Deciding what to build |
/team-task [action] | Task management | Record decisions |
/team-archive [range] | Archive closed tasks | Task cleanup |
/artifact [type] [title] | Save findings as artifact | Knowledge capture |
┌─────────────────────────────────────────┐
│ cmux-team daemon (TypeScript/bun) │
│ ┌───────────────────────────────────┐ │
│ │ TUI Dashboard │ │
│ │ Tasks: 2 open | Conductors: 1/3 │ │
│ └───────────────────────────────────┘ │
│ Queue ← Master/Hook write via CLI │
│ Loop → Task scan → Conductor spawn │
│ Monitor → Completion → Result collect │
└───────────┬────────────┬────────────────┘
│ │
[Master] [Conductor-035]
Claude Code Claude Code
(Opus) → [Agent] Claude Code
The Manager is not a Claude Code session. It's a TypeScript program with a deterministic event loop:
.team/queue/) for communication (no cmux send-key)depends_on field---
id: 13
title: Consolidated report
status: ready
depends_on: [10, 11, 12] # waits for all to complete
---
| Direction | Mechanism |
|---|---|
| Master → daemon | CLI (main.ts send) → .team/queue/*.json |
| daemon → Conductor | cmux new-split + Claude Code launch |
| Conductor → daemon | SessionEnd hook + cmux list-status polling |
All API requests are automatically recorded through the built-in proxy when the daemon is running.
# Filter by task ID
cmux-team trace --task 035
# Full-text search (SQLite FTS5)
cmux-team trace --search "error"
# Show trace details (including request/response bodies)
cmux-team trace --show 42
Traces are stored in .team/traces/traces.db with request/response bodies in .team/logs/traces/bodies/.
bun not installed: brew install oven-sh/bun/bun
Not in cmux: Run inside cmux. CMUX_SOCKET_PATH must be set.
Official prompts.chat marketplace - AI prompts, skills, and tools for Claude Code
Open Design — local-first design app exposed to coding agents over MCP. Install once with your agent's plugin command and projects/files/skills are reachable through stdio.
Behavioral guidelines to reduce common LLM coding mistakes, derived from Andrej Karpathy's observations