nntrivi2001
17d56d0e01
Clean break, no compatibility alias. Renames the product name, the CLI binary (`ccam` -> `agenthub`), the env var prefix (`CCAM_` -> `AGENTHUB_`), the Prometheus metric namespace (`ccam_*` -> `agenthub_*`), the tmux session prefix (`ccam-lane-<id>` -> `agenthub-lane-<id>`), the per-repo runtime profile directory (`.ccam/profile` -> `.agenthub/profile`), the lanes state root (`~/.claude/ccam-lanes` -> `~/.claude/agenthub-lanes`), the bundled plugins (`plugins/ccam*` -> `plugins/agenthub*`) and their slash commands (`/ccam-doctor` -> `/agenthub-doctor`, `/ccam:*` -> `/agenthub:*`). Because there is no alias, an existing install has to be updated by hand: rename its `.ccam/profile` directory and any `CCAM_*` variables, and reinstall the plugin under its new name. Two other name families are deliberately left alone here, since they are not just strings: the `Claude-Code-Monitor` repository/marketplace name, and the `agent-dashboard` npm package plus its `~/.claude/agent-dashboard` runtime directory, which holds the live database and needs a migration rather than a rename. Verified: server 1406/1406, client 459/459, `grep -i ccam` clean across tracked files, `openapi.yaml` regenerated (95 paths, unchanged count).
74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
---
|
|
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 AgentHub 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
|
|
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 ║
|
|
╚══════════════════════════════════════╝
|
|
```
|