---

name: dashboard-status description: > Quick dashboard health and status overview — checks the Agent Monitor API (port 4820), reports session/agent/event counts from /api/stats, confirms WebSocket connectivity, reads the redacted hook status returned by /api/settings/info, and shows data freshness (last event timestamp). Use to verify the monitoring system is operational.

Dashboard Status

Quick status check on the Claude Code Agent Monitor dashboard.

Input

The user provides: $ARGUMENTS

Options: empty (default: full status), "quick" (API only), "verbose" (include endpoint details).

Data Sources

Endpoint	Returns
GET /api/health	HTTP 200 if API is running
GET /api/stats	{ total_sessions, active_sessions, active_agents, total_agents, total_events, events_today, ws_connections, agents_by_status, sessions_by_status }
GET /api/settings/info	Dashboard configuration: version, port, data paths
GET /api/events?limit=1	Most recent event (for freshness check)

Status Report

1. API Server

• Reachable at http://localhost:4820? Response time?
• If unreachable: suggest npm start from the project directory

2. System Counts

From /api/stats:

• Total sessions tracked (total_sessions)
• Active agents currently running (active_agents)
• Total events ingested (total_events)
• Events today (events_today)
• WebSocket connections (ws_connections)

3. Data Freshness

From latest event:

• Time since last event ingested
• If >1 hour: warn about possible hook disconnect

4. Hook Status

Use /api/settings/info → hooks for configured hook names:

• Expected: PreToolUse, PostToolUse, Stop, SubagentStop, Notification, SessionStart, SessionEnd
• Report which hook names are present vs missing. Do not read hook commands or unrelated settings.

5. Dashboard Info

From /api/settings/info:

• Dashboard version
• Database path and size
• Configured port

Output Format

Compact status card:

╔══════════════════════════════════════╗
║   AGENT MONITOR STATUS              ║
╠══════════════════════════════════════╣
║   API:        ✅ Online (42ms)      ║
║   Sessions:   127 tracked           ║
║   Events:     4,892 ingested        ║
║   Hooks:      7/7 configured        ║
║   Last Event: 3 minutes ago         ║
╚══════════════════════════════════════╝