status · hoangsonww — Claude Code command: what it does, how to install
Polls the local Claude Code Agent Monitor dashboard to print health status and session counts in a single line.
MIT ★ 1,198 updated 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-dashboard@claude-code-agent-monitor-pluginsWhat status does
The command issues a curl request with a 5-second timeout to http://localhost:4820/api/stats. It reads specific metrics from the returned JSON payload: session counts, active agents, total and daily events, plus WebSocket connections.
It does not touch any data and prints exactly one line without introductory phrases. If the request fails, exits with an error code, or returns empty JSON, it returns a DOWN status explaining how to start the service via npm start from the repo root.
Without a running dashboard instance listening on port 4820, the command consistently reports a connection failure.
What it helps with
- verify Claude Code Agent Monitor dashboard availability
- inspect active agent and session counts
- check total event numbers and WebSocket connections
Example prompts for the agent
- Run
/ccam-dashboard-statusto inspect dashboard health - Check dashboard metrics at
http://localhost:4820using/ccam-dashboard-status
How to install status
1Plugin marketplace
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-dashboard@claude-code-agent-monitor-plugins2Manually: put the files in place
.claude/commands/ccam-dashboard-status.mdThe built-in /status overrides a file with the same name, so the file is renamed. Call it with /ccam-dashboard-status. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/status.mdCall it with /prompts:status. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/status.prompt.mdManually: put the files in place
.gemini/commands/status.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about status
How to install status in Claude Code?
Run /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, then run /plugin install ccam-dashboard@claude-code-agent-monitor-plugins.
What does the status command do?
It queries http://localhost:4820/api/stats to report whether the monitor is running, displaying session and event totals.
What happens if the dashboard is unreachable?
It displays a DOWN warning and instructs you to start the server using npm start from the repository root.
Source text
status.md · MIT
--- description: One-line Agent Monitor health + counts summary from /api/stats --- Fetch the dashboard stats and print a single-line health summary. Run: ```bash curl -s -m 5 http://localhost:4820/api/stats ``` Then print exactly one line summarizing health and key counts from the JSON, in this shape: ``` ✅ UP | 127 sessions | 3 active | 1 agents | 4,892 events | 42 today | 2 ws ``` Pull the numbers from these fields: `total_sessions`, `active_sessions`, `active_agents`, `total_events`, `events_today`, `ws_connections`. If the `curl` command fails (non-zero exit, empty body, or unparseable JSON), print instead: ``` ❌ DOWN | dashboard not reachable at http://localhost:4820 — start it with `npm start` from the repo root ``` Do not modify any data. Output only the single summary line — no preamble.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →status by other authors comes first.