Dashboard Pages
Overview
Landing page with live summary: running agents with progress, queued issues waiting for slots, completed work with success/failure breakdown, and aggregate token usage across all workers.
Queue
Kanban-style board showing issues organized by workflow stage. Each card displays the issue identifier, title, current status, model in use, attempt count, and token usage.
Issue Detail
Click any issue to inspect its full event timeline, attempt history (current + archived), model override controls, agent conversation log, and workspace status.
Attempts
Per-issue attempt history showing each run’s outcome, duration, token consumption, model used, and the complete event stream for debugging.
Logs
Streaming view of all orchestrator events — issue lifecycle (queued, started, completed), worker events (spawn, failure, OOM), agent events (tool calls, file edits), and system events (polls, errors).
Git Context
Repository and workspace information: current branch, commit history, and diff viewer for each active workspace.
Runs
Historical view of all agent runs with filtering by status, duration, and model. Drill into any run to see its full event timeline.
Notifications
Notification delivery history showing which events were sent to which channels, delivery status, and any failures.
Observability
Prometheus metrics endpoint at
/metrics with agent run counts, token usage histograms, poll duration, and error rates.Settings
Visual editor for the config overlay. Changes take effect immediately — equivalent to
PUT /api/v1/config/overlay.Setup
Re-run the setup wizard to reconfigure credentials without a factory reset. Located under System → Setup.
Templates
Prompt template editor with CodeMirror for syntax highlighting. Customize the system prompt, planning prompt, and review prompt sent to agents.
Workspaces
Inventory of all active workspaces: path, associated issue, branch name, disk usage, and a delete action for cleanup.
Audit Log
Immutable history of all config, secret, and template mutations — who changed what, when, and the before/after values.
Real-time Events (SSE)
The dashboard connects toGET /api/v1/events via SSE and updates all views live. On connect, the client receives {"type":"connected"}. Subsequent frames carry typed event payloads:
| Event | Description |
|---|---|
issue.started | Agent worker launched for an issue |
issue.completed | Agent finished (any terminal outcome) |
issue.stalled | Stall detected — agent killed |
issue.queued | Issue waiting for an available slot |
worker.failed | Worker crash, timeout, or OOM |
model.updated | Model selection changed at runtime |
workspace.event | Workspace lifecycle (preparing, ready, failed) |
agent.event | Raw agent event from the worker stream |
poll.complete | Polling cycle finished |
system.error | System-level error not tied to a specific issue |
audit.mutation | Config, secret, or template change logged |
webhook.received | Verified webhook delivery from Linear |
webhook.health_changed | Webhook health state machine transition |
A keep-alive comment (
:) is sent every 30 seconds to prevent proxy timeouts. If the SSE connection drops, the dashboard reconnects automatically and shows a stale-data banner until events resume.Keyboard Shortcuts
The dashboard supports full keyboard navigation. All interactive elements — buttons, cards, step indicators — are accessible via standard keys:| Key | Action |
|---|---|
Tab | Move focus between interactive elements |
Enter / Space | Activate the focused element |
Cmd+K / Ctrl+K | Open the command palette |
What’s Next
Notifications
Configure Slack alerts and webhook integrations.
Observability
Set up Prometheus/Grafana monitoring for production.