# Live Watch

Polls the Agent Monitor /api/stats endpoint several times over a short window and...

- Repository: https://github.com/hoangsonww/Claude-Code-Agent-Monitor (1136 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill live-watch -g -a claude-code -y`
Codex: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill live-watch -g -a codex -y`
Cursor: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill live-watch -g -a cursor -y`
Gemini CLI: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill live-watch -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor`

## Description

Polls the Agent Monitor /api/stats endpoint several times over a short window and reports the live deltas in active_sessions, active_agents, events_today, and ws_connections so you can see activity moving in real time. Use when watching the dashboard for live changes rather than a one-time snapshot.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Live Watch

Watch the dashboard's live counters change over a short window by polling
`/api/stats` a few times and reporting the deltas.

## Input

The user provides: **$ARGUMENTS**

Interpreted as the watch shape: number of polls and/or interval (e.g. `5x3s` =
5 samples 3 seconds apart). Defaults when empty: **5 samples, ~3 seconds apart**
(a ~15-second window). A bare number means that many samples at the default
interval; a bare duration means the default sample count at that interval.

## Data Sources

| Endpoint | Returns |
|----------|---------|
| `GET /api/stats` (polled) | `{ total_sessions, active_sessions, active_agents, total_agents, total_events, events_today, ws_connections, agents_by_status, sessions_by_status }` |

## Method

Poll `GET /api/stats` once per interval for the configured number of samples,
recording the timestamp and the four watched counters each time. Pace the polls
with a short wait between requests; keep the total window short (seconds, not
minutes) so it stays interactive.

If the very first poll fails to connect, the dashboard is down, stop and tell
the user to start it with `npm start` (or `npm run dev`) from the repo root,
then retry.

## Report Sections

### 1. Watch Window
State the sample count, interval, and total elapsed window.

### 2. Sample Timeline
A Markdown table, one row per poll, with columns:
`#`, `time`, `active_sessions`, `active_agents`, `events_today`, `ws_connections`.

### 3. Deltas
For each of the four watched counters, report the net change from the first to
the last sample using ▲ (increase), ▼ (decrease), or `=` (no change). Note any
mid-window spikes or dips visible in the timeline.

### 4. Verdict
One line: is the dashboard actively receiving traffic (counters moving) or idle
(flat) over the window?

## Output

The rest: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/blob/HEAD/plugins/ccam-dashboard/skills/live-watch/SKILL.md