doctor · hoangsonww — Claude Code command: checks and installation
doctor is a Claude Code command that checks connectivity to the Agent Monitor dashboard and probes its APIs. It reports stats and update status in two checks.
MIT ★ 1,198 updated 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-devtools@claude-code-agent-monitor-pluginsWhat doctor does
doctor sends requests to the Agent Monitor stats API at http://localhost:4820/api/stats and its update-status endpoint at http://localhost:4820/api/updates/status. Each check passes only when the response is HTTP 200 with valid JSON. The report includes session and event counts, plus update availability and version details when present.
The command prints a result for each endpoint and an overall status. A failed connection or non-200 response marks that check as failed and adds a message to start the dashboard with npm start from the repository root. Agent Monitor must be running at localhost:4820.
What it helps with
- check whether the Agent Monitor dashboard responds
- read active session and daily event counts
- test the update-status endpoint
- print a pass-or-fail health report
Example prompts for the agent
- Run
/ccam-devtools:doctorto check the Agent Monitor dashboard. - Use
/ccam-devtools:doctorto report session stats and update status. - Check whether the dashboard responds at
localhost:4820with/ccam-devtools:doctor.
How to install doctor
1Plugin marketplace
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-devtools@claude-code-agent-monitor-plugins2Manually: put the files in place
.claude/commands/ccam-devtools-doctor.mdThe built-in /doctor overrides a file with the same name, so the file is renamed. Call it with /ccam-devtools-doctor. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/doctor.mdCall it with /prompts:doctor. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/doctor.prompt.mdManually: put the files in place
.gemini/commands/doctor.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about doctor
How do I install doctor in Claude Code?
Run /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, then /plugin install ccam-devtools@claude-code-agent-monitor-plugins. The command file is .claude/commands/ccam-devtools-doctor.md.
What does doctor do?
It checks the Agent Monitor stats API and update-status endpoint, then prints each result and an overall status.
What does doctor need to run?
Agent Monitor must be running at localhost:4820. If the dashboard cannot be reached, the command reports that it can be started with npm start from the repository root.
Source text
doctor.md · MIT
---
description: Quick connectivity + health probe of the Agent Monitor dashboard.
---
Run a fast health probe against the Agent Monitor dashboard at
`http://localhost:4820`. Do two checks and print OK / FAIL for each.
1. **API + stats** — fetch core stats:
```bash
curl -s -o /dev/null -w '%{http_code}' http://localhost:4820/api/stats
curl -s http://localhost:4820/api/stats
```
PASS if HTTP 200 and the body is valid JSON. From the body, surface
`total_sessions`, `active_sessions`, `total_events`, and `events_today`.
2. **Self-update status** — confirm the update subsystem responds:
```bash
curl -s -o /dev/null -w '%{http_code}' http://localhost:4820/api/updates/status
curl -s http://localhost:4820/api/updates/status
```
PASS if HTTP 200 and valid JSON. Surface whether an update is available and
the current vs latest version if present.
Print a compact report, one line per check:
```
Agent Monitor Doctor
API /api/stats ............ OK (sessions=12 active=1 events=3480 today=57)
/api/updates/status ....... OK (up to date — v1.x.x)
Overall: OK (2/2)
```
Use ✅ OK / ❌ FAIL markers. If any curl fails to connect (non-200 or no
response), mark that check FAIL and end with: "Dashboard unreachable — start it
with `npm start` from the repo root." Keep it to the report only; no extra prose.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor
Similar slash commands
All slash commands for Testing and QA →doctor by other authors comes first.