ping — Claude Code command: what it does, how to install
ping is a Claude Code command that checks the local Agent Monitor dashboard API and reports its reachability.
MIT ★ 1,198 updated 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-dashboard@claude-code-agent-monitor-pluginsWhat ping does
The command runs a curl request against http://localhost:4820/api/stats with a 5-second timeout. It checks the HTTP status code and total round-trip time. It does not modify project data.
Output stays limited to a single line without commentary. On receiving a 2xx HTTP code, it prints an UP status alongside latency in seconds or milliseconds. If curl fails due to a timeout, connection refusal, or an error status code, it prints DOWN and reminds you to launch the server with npm start or npm run dev from the repository root.
Without curl installed and the dashboard active on port 4820, the probe fails immediately.
What it helps with
- check Agent Monitor dashboard API reachability
- measure response latency for
http://localhost:4820/api/stats - verify local monitor availability in a single line
Example prompts for the agent
- /ping
- Check if the agent monitor dashboard is running
How to install ping
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/ping.mdCall it with /ping. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/ping.mdCall it with /prompts:ping. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/ping.prompt.mdManually: put the files in place
.gemini/commands/ping.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about ping
How to install ping 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 ping command do?
It queries http://localhost:4820/api/stats via curl with a 5-second timeout and reports either UP or DOWN with response time.
What should I do when ping reports DOWN?
Start the dashboard server from the root of the repository by running npm start or npm run dev.
Source text
ping.md · MIT
---
description: Check Agent Monitor reachability and print UP/DOWN with latency
---
Check whether the dashboard API is reachable and report latency.
Run:
```bash
curl -s -o /dev/null -m 5 -w '%{http_code} %{time_total}s' http://localhost:4820/api/stats
```
`%{http_code}` is the HTTP status and `%{time_total}` is the total round-trip
time in seconds.
Print one line:
- If the request succeeds with a 2xx status:
```
✅ UP | http://localhost:4820/api/stats | 200 | 0.042s
```
(use the real status code and the real latency, converting seconds to ms if
clearer, e.g. `42ms`).
- If `curl` exits non-zero (connection refused/timeout) or the status is not 2xx:
```
❌ DOWN | http://localhost:4820/api/stats unreachable — start it with `npm start` (or `npm run dev`) from the repo root
```
Output only the single line — no preamble. Do not modify any data.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor