---

name: live-watch 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.

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

• Compact Markdown. The timeline table is the centerpiece.
• Cite real values from each poll — never interpolate or invent samples.
• Deltas use ▲/▼/= with the signed numeric change, e.g. events_today: ▲ +7.
• Keep it scannable in a terminal — no padding beyond the table.