Health Check

This runs a systematic health check on your Claude Code Agent Monitor installation, hitting all the critical components: API endpoints, database integrity, WebSocket connectivity, hook configuration, and data freshness. You get a clean ASCII dashboard showing what's working and what's not, with response times and specific failure details. It's the diagnostic you run when something feels off or after making configuration changes. The tiered check modes (quick, full, deep) are smart since you don't always need the full battery of tests. One thing to appreciate is the remediation guidance for failed checks, though the skill doc doesn't detail what those suggestions look like in practice.

GitHub stars: 455
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add hoangsonww/claude-code-agent-monitor --skill health-check --agent claude-code

Installs into .claude/skills of the current project.

Files

Health Check

Run a comprehensive health check on the Agent Monitor system.

Input

The user provides: $ARGUMENTS

This may be:

"full" or empty (default: run all checks)
"quick" for a fast connectivity check
"deep" for extended checks including database integrity

Procedure

Run health checks in this order:

1. API Health

curl -sf http://localhost:4820/api/health

Verify HTTP 200 response
Check response time (<500ms expected, <1000ms acceptable)
Confirm JSON response body

2. Database Health

curl -sf http://localhost:4820/api/stats

Verify stats endpoint returns valid data
Check that counts are non-negative integers
Verify database file exists and has reasonable size

3. WebSocket Health

Check that the WebSocket server is listening
Verify WebSocket upgrade is supported on the dashboard port

4. API Endpoint Validation

Test each major endpoint:

curl -sf http://localhost:4820/api/sessions?limit=1
curl -sf http://localhost:4820/api/events?limit=1
curl -sf http://localhost:4820/api/analytics
curl -sf http://localhost:4820/api/pricing
curl -sf http://localhost:4820/api/settings/info

SKILL.md on GitHub