# Clawmates Visualization Layer — install package

A seamless, self-contained drop for a Linux node. It serves the three Clawmates
visualizations and feeds them **live** from the durable runner.

```
handoff/
├── AGENT_HANDOFF.md          ← READ THIS FIRST. Deep setup + real-time wiring guide for the agent.
├── install.sh                ← one-shot installer (idempotent)
├── .env.example              ← copy → .env, edit for live mode
├── visualizations/           ← the UI (open directly in a browser, no build step)
│   ├── Clawmates World.dc.html      · Large World: Hierarchy · Flat · Live (Gource) formations
│   ├── Clawmates Observe.dc.html    · Agent close-up + System mission-control
│   ├── Clawmates Dashboard.dc.html  · Tiered admin: org→company→team→claw + topology morph
│   └── support.js                   · the .dc.html runtime (required next to the html)
└── realtime/                 ← the live bridge (dependency-free Node ≥20)
    ├── server.mjs                   · demo + live SSE bridge
    ├── clawmates-live.js            · browser client adapter (window.ClawmatesLive)
    ├── events.schema.json           · the Clawmates Event Taxonomy (JSON Schema)
    └── package.json
```

## 60-second start (demo, no backend)

```bash
chmod +x install.sh && ./install.sh
(cd realtime && CLAWMATES_MODE=demo node server.mjs) &
caddy file-server --root ./visualizations --listen :8080   # or: npx serve ./visualizations -l 8080
```

Open **http://localhost:8080/Clawmates%20World.dc.html?live=http://localhost:8420/live**, switch to
the **Live** formation, and watch the agents converge on real events from the bridge.

Then read **AGENT_HANDOFF.md** to wire it to `cm-api` for production.