/dashboard-status

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         ║
╚══════════════════════════════════════╝