Skip to main content
command CX Codex

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

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

What 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-status to inspect dashboard health
  • Check dashboard metrics at http://localhost:4820 using /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-plugins

2Manually: put the files in place

.claude/commands/ccam-dashboard-status.md

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

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.

status Seth Hobson Shows Conductor project status, active tracks, and next actions. Use it to inspect task progress and spot blockers. CX Codex +1 348installs status official Vercel Labs status inspects the state of a linked Vercel project, including recent deployments, domain health, and log drain setup. CX Codex GP ChatGPT +1 348installs status OthmanAdi Displays current task phases, completion percentage, and errors from task_plan.md. Runs when you need a quick status check without loading companion files into context. CX Codex +1 ★ 28,179repo stars status carlrannaberg status evaluates repository state via Git, categorizes modified files by type, and suggests actions before commits or rebases. CX Codex +1 ★ 763repo stars status OthmanAdi status reads task_plan.md to display phase milestones and summarizes notes from findings.md. CX Codex +1 ★ 540repo stars memory-status Alireza Rezvani Reports the state of all project memory files: line counts, topic files, capacity thresholds, and stale references. Triggered by /si:memory-status or any question about how full the agent memory is. CX Codex +1 27installs affiliate-performance-dashboard Maya-Beth Finotti affiliate-performance-dashboard is a Claude Code skill that turns reporting requirements into an affiliate dashboard spec with metric formulas, audience views, and alert thresholds. CX Codex +1 17,600installs ar-status Alireza Rezvani ar-status is a Claude Code skill that displays autoresearch results, active loops, and progress. Run /ar:ar-status or ask how an experiment is going. CX Codex +1 7installs groove-utilities-stats andreadellacorte groove-utilities-stats prints a read-only dashboard over the groove memory folder: lessons captured and graduated, daily-log streaks, task counts and commits for a chosen period. CX Codex +1 265installs agent-9-status-monitor happycapy-ai agent-9-status-monitor — a Claude subagent that polls your open pull requests, catches merges, closures, new reviews and CI failures, then updates the contribution history and alerts the other agents in the swarm. CX Codex ★ 138repo stars kpi-dashboard-design Seth Hobson The kpi-dashboard-design skill helps design KPI dashboards, choose useful metrics, and trace conflicting calculations. Use it for SaaS, operations, and cohort analysis views. CX Codex +1 16,141installs

From the same set155

The whole set →
release-guard release-guard is a Claude Code skill that checks a repository before merge or release, comparing documented commands with package.json and architecture notes with current code paths. CX Codex +1 ★ 1,198repo stars repo-onboarding repo-onboarding guides AI coding agents through codebase architecture, layer selection, and test command discovery before editing. CX Codex +1 ★ 1,198repo stars mcp-maintainer The mcp-maintainer skill guides maintenance of the repository’s local MCP server, from checking its API to validating tool changes. Use it when updating MCP tools or investigating runtime issues. CX Codex +1 ★ 1,198repo stars file-headers file-headers makes each source file open with a short, honest overview plus the exact line @author Son Nguyen <[email protected]>. CX Codex +1 ★ 1,198repo stars open-dashboard open-dashboard prints the Agent Monitor address and the commands to start or open it. Use it when you need the local dashboard instructions. CX Codex +1 ★ 1,198repo stars report-analyst report-analyst builds executive, cost, reliability and workflow reports from a local CCAM API, keeping units, scope and data freshness intact. Handy when a stakeholder summary has to hold up to scrutiny. CX Codex ★ 1,198repo stars ping ping is a Claude Code command that checks the local Agent Monitor dashboard API and reports its reachability. CX Codex +1 ★ 1,198repo stars repo-onboarding repo-onboarding maps a repository before coding, helping locate the right module, ownership, and checks for a planned change. CX Codex +1 ★ 1,198repo stars

Project sponsors

Companies that keep this analytics open