# The Hive: Multi-Agent Orchestration

> Build and operate multi-agent systems using cmux as the control plane — visible, steerable, auditable fleet orchestration from your terminal.

| Field | Value |
|-------|-------|
| URL | https://wizardshit.ai/the-hive-multi-agent-orchestration |
| Type | Course |
| Status | draft |
| Created | 2026-03-18 |
| Authors | Joel Hooks |
| Lessons | 10 |

The hive is under construction. This structured content stub gives The Hive a real route, manifest, and companion surface while the lesson text is being written.

The course builds on cmux's programmable terminal control plane to spawn, monitor, steer, and recover fleets of AI agents — all from a single terminal session.

## Lesson outline

1. [The Control Plane](/the-hive-multi-agent-orchestration/the-control-plane) — cmux as agent infrastructure — workspaces, surfaces, refs, and why your terminal multiplexer is the orchestration layer.
2. [The Bridge](/the-hive-multi-agent-orchestration/the-bridge) — How pi-cmux turns a terminal multiplexer into an agent-aware control surface — sidebar status, lifecycle hooks, and tool activity.
3. [The Fork Bomb](/the-hive-multi-agent-orchestration/the-fork-bomb) — Why spawning agents that spawn agents is the first failure mode — and the three-layer defense that prevents it.
4. [Your First Spawn](/the-hive-multi-agent-orchestration/your-first-spawn) — Build spawn\_pi — a single tool call that launches a worker agent in a visible terminal pane you can watch work.
5. [The Fleet Lifecycle](/the-hive-multi-agent-orchestration/the-fleet-lifecycle) — Read what workers are doing, steer them mid-flight, and shut them down — the four companion tools that make spawn\_pi useful.
6. [Shell Escaping Nightmares](/the-hive-multi-agent-orchestration/shell-escaping-nightmares) — When your prompt contains ! and zsh interprets it as history expansion — the real-world debugging story that led to temp files and @file syntax.
7. [When Designs Collapse](/the-hive-multi-agent-orchestration/when-designs-collapse) — The hive workspace pattern looked great on paper — dedicated workspace, nested splits, workspace naming. Reality deleted 88 lines.
8. [Completion Detection](/the-hive-multi-agent-orchestration/completion-detection) — The gap between 'tools the LLM calls' and 'infrastructure that runs alongside the LLM' — a polling loop that watches workers and notifies the orchestrator.
9. [The Attention Model](/the-hive-multi-agent-orchestration/the-attention-model) — Two signals for two audiences — sidebar is the quiet cross-workspace broadcast, notifications are the loud focus-stealing alert.
10. [Fleet Dashboard](/the-hive-multi-agent-orchestration/fleet-dashboard) — A TUI widget that shows all active agents — status, elapsed time, last activity — without switching workspaces.


## Lessons

01. [The Control Plane](https://wizardshit.ai/the-hive-multi-agent-orchestration/the-control-plane)
02. [The Bridge](https://wizardshit.ai/the-hive-multi-agent-orchestration/the-bridge)
03. [The Fork Bomb](https://wizardshit.ai/the-hive-multi-agent-orchestration/the-fork-bomb)
04. [Your First Spawn](https://wizardshit.ai/the-hive-multi-agent-orchestration/your-first-spawn)
05. [The Fleet Lifecycle](https://wizardshit.ai/the-hive-multi-agent-orchestration/the-fleet-lifecycle)
06. [Shell Escaping Nightmares](https://wizardshit.ai/the-hive-multi-agent-orchestration/shell-escaping-nightmares)
07. [When Designs Collapse](https://wizardshit.ai/the-hive-multi-agent-orchestration/when-designs-collapse)
08. [Completion Detection](https://wizardshit.ai/the-hive-multi-agent-orchestration/completion-detection)
09. [The Attention Model](https://wizardshit.ai/the-hive-multi-agent-orchestration/the-attention-model)
10. [Fleet Dashboard](https://wizardshit.ai/the-hive-multi-agent-orchestration/fleet-dashboard)

## Companion Skills

### the-hive-multi-agent-orchestration

Companion skill for The Hive: Multi-Agent Orchestration. This skill is in early development — it grows as lessons are built. Say "teach me" to start, or ask any question about the course topic.

**Install:**
```bash
npx skills add badass-courses/wizard-skills --skill the-hive-multi-agent-orchestration -y
```

---

<!-- clawmail-agent-prompt -->

## Agent Instructions

You are a teaching assistant for **The Hive: Multi-Agent Orchestration** on wizardshit.ai.

### Your Role

- Guide the student through each lesson in sequence
- Fetch individual lesson content by requesting lesson URLs with `Accept: text/markdown`
- Help the student understand concepts, debug code, and complete exercises
- If a companion skill is available, install it for deeper course-specific guidance

### How to Access Lesson Content

```bash
curl -H "Accept: text/markdown" https://wizardshit.ai/the-hive-multi-agent-orchestration/{lesson-slug}
```

Each lesson page returns its full content as markdown when requested this way.
Lessons may have **branches** (alternative paths) — check the lesson page for branch links.

### Teaching Approach

1. Start by orienting the student: explain what the course covers and where they'll end up
2. Work through lessons in order — each builds on the previous
3. When the student gets stuck, fetch the relevant lesson content and help them through it
4. Encourage them to actually build and run the code, not just read it
5. If branching lessons exist, help them choose the right path for their context