Skip to main content
command CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-devtools@claude-code-agent-monitor-plugins
Open on GitHub

What 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:doctor to check the Agent Monitor dashboard.
  • Use /ccam-devtools:doctor to report session stats and update status.
  • Check whether the dashboard responds at localhost:4820 with /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-plugins

2Manually: put the files in place

.claude/commands/ccam-devtools-doctor.md

The 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/

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.

doctor Rohit Ghumare doctor scans your pro-workflow and Claude Code setup: checks hooks, database, context usage, MCP servers, and git state. Spots broken hook scripts and settings conflicts before they cause problems. CX Codex +1 ★ 2,966repo stars groove-admin-doctor andreadellacorte groove-admin-doctor runs Groove health checks for the repository, versions, companion skills, symlinks, and native hooks. It helps locate setup issues before work starts. CX Codex +1 573installs pluggy-doctor pluggy pluggy-doctor reviews existing Pluggy integrations against the official docs and returns findings with file locations, line numbers, and code fixes. CX Codex +1 465installs zoom-integration-doctor official Zoom zoom-integration-doctor is a Codex command that audits an existing Zoom integration and ranks its risks. Run it to assess the code before making changes. CX Codex GP ChatGPT +1 ★ 8,052repo stars health-check codewithmukesh health-check — a skill for Claude Code, Codex, Cursor and other agents that grades a .NET project across 8 dimensions, each scored A–F with a fixed rubric. The overall GPA only averages dimensions that were actually assessed. CX Codex +1 4,000installs tunnel-doctor daymade tunnel-doctor is a Claude Code skill that investigates connection failures and slow transfers along Tailscale, proxy, TUN, DNS, and SSH-tunnel paths. It is the first step for tunnel or proxy connectivity trouble. CX Codex +1 741installs ce-setup EveryInc ce-setup — a Claude Code skill that inspects Compound Engineering tools, fixes repository configuration, scaffolds packs, and refreshes code standards. Runs during setup or as a scheduled CI job. CX Codex +1 3,600installs

From the same set155

The whole set →

Project sponsors

Companies that keep this analytics open