Auto-starts at http://localhost:3421 on first MCP connection, or run standalone with node dist/server.js.
| View | Description |
|---|---|
| Overview | Stats cards, active agents with status dots, recent activity feed |
| Agents | Agent cards with capabilities, status text, message counts, click-to-filter |
| Messages | Split-pane: compact list with avatars + full detail with markdown rendering |
| Channels | Channel cards with message counts, click-to-filter messages |
| State | Key-value table with namespace/key filtering |
| Activity | Structured event feed — commits, test results, file edits, errors across all agents |
Agent cards display capability tags, status text, heartbeat age, and message counts. Click any card to filter messages by that agent.
Unified timeline of structured events across all agents. Filter by event type (commit, test_pass, error, file_edit, task_complete, etc.).
- Light + dark theme (persisted in localStorage)
- Real-time WebSocket updates (no polling, diff-aware rendering)
- Full markdown rendering in message detail (GFM, code blocks, tables, task lists)
- Full-text search powered by FTS5 (searches all messages in database, not just visible ones)
- Agent/channel filtering with removable filter chips
- Thread expansion with inline replies
- Importance badges (urgent, high)
- Forwarded message detection with styled attribution
- Handoff messages rendered with distinct orange styling and swap icon
- Branch indicators on messages showing fork points and branch listings in detail view
- Stuck detection — "idle" badge with time since last activity on agent cards when agents are alive but inactive
- Toast notifications for agent join/leave and new messages
- Nav badges with live counts
- Total message count from database (not capped by local display limit)
- ARIA attributes + keyboard navigation
- Mobile responsive with collapsible sidebar
- Purge button to clear old messages
Dashboard connects via WebSocket for real-time updates:
- On connect: receives full state snapshot (
type: "state") withagents,channels,messages,messageCount,state,feed,branches - Per event: receives incremental updates (
agent:registered,message:sent,state:changed, etc.) - Send
{ "type": "refresh" }to request a fresh full state - Event subscription: send
{ "type": "subscribe", "events": ["message:sent", "agent:registered"] }to filter events - Ping/pong heartbeat every 30s for connection health detection
- Max 50 concurrent WebSocket connections