Skip to content

Web Dashboard

A browser-based dashboard for monitoring and managing ARC from any device on your network. All views are wired to real data with full management actions — create, update, and delete resources directly from the browser. Built with the Nothing design system — OLED dark mode, Space Grotesk/Space Mono typography, and a minimal technical aesthetic.

Starting the Dashboard

bash
arc web                    # Start on default port (3700)
arc web --port 4000        # Custom port
arc web --host 0.0.0.0    # Expose on network

TIP

The dashboard binds to localhost by default. Pass --host 0.0.0.0 to expose it on your local network.

Development Mode

bash
pnpm dev:dashboard         # Hot-reload from source

Architecture

The dashboard is a standalone package at packages/dashboard/ built on raw node:http — no Express dependency.

REST API

14 resource endpoints under /api/* with read and write operations:

EndpointMethodsDescription
/api/overviewGETSystem overview (profiles, active session, health, hook pipeline)
/api/sessionsGET, PATCHSession list, complete/suspend sessions
/api/tracesGETExecution trace history
/api/riskGETRisk classification results
/api/tasksGET, POST, PATCH, DELETETask CRUD — create, update status, delete
/api/skillsGET, POST, DELETESkill registry — list, reload, remove
/api/memoryGET, POST, DELETEMemory entries — add, search, delete
/api/agentsGET, POST, DELETERemote agents — add, remove, health check
/api/factoryGET, POSTDark Factory state, waves, abort
/api/profilesGET, PATCH, DELETEProfile list, switch active, delete
/api/pluginsGET, PATCHPlugin registry, enable/disable
/api/healthGETHealth check endpoint
/api/hooksGETHook pipeline state — registered hooks, enforcement, decisions
/api/syncGET, POSTSync status, pull/push shared layer

WebSocket

Real-time event push over WebSocket (RFC 6455). All mutations broadcast updates to connected clients, including:

  • Profile switches and deletions
  • Task create, status change, and delete
  • Session lifecycle events (complete, suspend)
  • Factory wave progression and abort
  • Risk alerts
  • Memory additions and deletions
  • Agent registry changes and health check results
  • Plugin enable/disable state changes
  • Sync pull/push progress
  • Hook pipeline decisions

The SPA frontend auto-reconnects on WebSocket disconnection.

Frontend Views

The SPA includes 14 modular view components, all wired to real data with management actions:

ViewReadWrite Actions
OverviewSystem dashboard with stat rows, status indicators, hook pipeline summary--
SessionsActive and suspended sessions with timelineComplete, suspend sessions
TracesExecution trace inspector with filtering--
RiskRisk classification breakdown with segmented bars--
TasksTask board with status and priority groupingCreate, update status, delete
SkillsLoaded skill registry with trigger infoReload, remove skills
MemoryMemory browser with search and scope filteringAdd entries, search, delete, filter by scope/type
AgentsRemote agent registry with health statusAdd, remove, health-check agents
FactoryDark Factory wave progression and consensus gatesAbort running factory
ProfilesProfile list with auth status and active indicatorSwitch active profile, delete profiles
DiagnosticsSystem health checks and environment info--
SyncShared layer sync status and conflict resolutionPull/push shared layer
PluginsPlugin registry with status indicatorsEnable/disable plugins
Hook PipelineLive monitor — registered hooks, enforcement mode, recent decisions--

TIP

All write actions broadcast changes over WebSocket, so every connected browser tab sees updates in real time.

TUI Sidebar

The TUI dashboard has 12 sidebar views: Dash, Work, Profiles, Doctor, Tasks, Memory, Skills, Settings, Guide, Sync, Traces, and Agents. All views are wired to real data with keyboard-driven management actions.

Hook Pipeline Monitor

The Hook Pipeline view provides real-time visibility into ARC's supervision backbone. It displays:

  • Registered hooks — name, priority, and current enforcement mode for each hook in the pipeline
  • Enforcement mode — the active enforcement mode (off, log, advise, enforce) for the current profile
  • Recent decisions — a live feed of hook evaluations with pass/flag/block results and timestamps
  • Circuit breaker state — whether the breaker is closed (normal), open (degraded), or half-open (testing)

This view is read-only and auto-refreshes as new hook decisions arrive over WebSocket. See Hooks & Supervision for details on configuring the hook pipeline.

Interface Capability Matrix

ARC provides three interfaces — CLI, TUI, and Web Dashboard — with overlapping but distinct capabilities:

FeatureCLITUIWeb
Task CRUDFullFullFull
Memory managementFullFullFull
Skills managementFullRead + reloadRead + reload
Plugin managementFull--Enable/disable
Remote agentsFullFullFull
Sync managementFullFullFull
Session controlFullInteractiveComplete/suspend
Factory controlStatus + abort--Status + abort
Hook pipelineRuns in-process--Live monitor
Profile managementFullFullSwitch + delete

TIP

The CLI remains the most complete interface. The TUI excels at interactive workflows with keyboard shortcuts. The Web Dashboard is best for monitoring and managing ARC from another device.

Design

The dashboard uses ARC's Nothing-inspired design system:

  • Typography — Space Grotesk (body), Space Mono (code, data)
  • Dark mode — OLED black (#000000 bg, #111111 surfaces)
  • Light mode — warm whites with subtle gray surfaces
  • Accent — Red (#D71921) for active states and alerts
  • Data display — segmented progress bars, stat rows, tag system, phase indicators
  • Navigation — SPA router with view switching, dark/light toggle