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, validates hook configuration in ~/.claude/settings.json, 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 startfrom 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
Check ~/.claude/settings.json for configured hooks:
- Expected: PreToolUse, PostToolUse, Stop, SubagentStop, Notification, SessionStart, SessionEnd
- Report which hooks are present vs missing
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 ║
╚══════════════════════════════════════╝