Files

T

nntrivi2001 17d56d0e01 refactor!: rebrand CCAM to AgentHub

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).

2026-09-07 12:09:15 +07:00

2.5 KiB

Raw Blame History

description

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

2.5 KiB Raw Blame History