Dashboard

The erg dashboard provides a real-time web interface for monitoring all running orchestrators and their work items. It uses Server-Sent Events (SSE) for live streaming updates.

live simulation

erg orchestrator dashboard

connected

Start the dashboard:

terminal

erg dashboard              # Start on default port 21122
erg dashboard --port 8080  # Start on custom port

Flag	Description
`--port`	Port for the dashboard server (default: 21122)

Features

Summary bar — aggregate counts across all orchestrators: orchestrator count, active/queued/completed/failed items, total spend, and token usage
Per-orchestrator sections — each running orchestrator gets its own section showing repo name, PID, uptime, slot count, and cost
Work item cards — each work item displays its issue reference, current workflow step, phase, age, cost, and feedback rounds. Cards are color-coded by state: orange border for active, green for completed, red for failed, gray for queued
Live session logs — click any work item card to expand it and view the live session log. Tool calls are shown in cyan, text output in gray. Logs auto-refresh every 3 seconds
PR links — completed items show clickable links to their pull requests
Error display — failed items show the error message inline
Connection status — header indicator shows whether the SSE connection is live

API

The dashboard exposes a small HTTP API that can be used for custom integrations or scripting.

Endpoint	Description
`GET /`	Serves the embedded dashboard UI
`GET /api/state`	Returns current state as JSON (one-shot)
`GET /api/events`	SSE stream — pushes state JSON on every change (polled every 1.5s)
`GET /api/logs/{sessionID}?tail=N`	Returns parsed session log lines (default tail=200). Each line has a type (`"text"` or `"tool"`) and text content

made by zack · mit license