monitor-stream

Streams live swarm events as NDJSON for real-time agent observability.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill monitor-stream
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: monitor-stream
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-swarm/skills/monitor-stream
Command: npx skills add https://github.com/ruvnet/claude-flow --skill monitor-stream

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @claude-flow/cli.

What problem does it solve?

Polling swarm status in a loop wastes tokens and misses transient events. This Skill streams swarm events in real time so you get immediate notifications when agents spawn, tasks complete, memory is written, or health checks run.

Core Features & Use Cases

  • Live Event Streaming: Runs npx @claude-flow/cli@latest swarm watch --stream via the Monitor tool, emitting NDJSON events for agent spawns, task completions, memory writes, and health checks.
  • One-Shot Status Checks: Falls back to MCP tools swarm_status and swarm_health when a single snapshot is sufficient.
  • Use Case: While a multi-agent swarm executes a long task, stream its events so each agent spawn and task completion triggers a notification instead of repeatedly polling swarm status.

Quick Start

Ask the assistant to monitor the swarm in real time using the monitor-stream skill so you receive a notification for every agent spawn and task completion.

Frequently Asked Questions about monitor-stream

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor claude-flow swarm events in real time?

Run `npx @claude-flow/cli@latest swarm watch --stream` through the Monitor tool. It streams NDJSON events for agent spawns, task completions, memory writes, and health checks, with each stdout line triggering a notification.

Should I poll swarm status or stream swarm events?

Streaming is preferred over polling `swarm status` in a loop. The stream delivers events as they happen without repeated command invocations, as recommended in ADR-091. Use polling only for occasional one-shot checks.

How do I get a one-time swarm status snapshot?

Use the MCP tools `mcp__plugin_ruflo-core_ruflo__swarm_status` or `mcp__plugin_ruflo-core_ruflo__swarm_health` for a single status or health snapshot instead of starting a continuous event stream.

What events does the swarm watch stream emit?

The stream emits NDJSON events covering agent spawns, task completions, memory writes, and health checks. Each line of stdout from the watch command triggers a separate notification through the Monitor tool.

When should I not use the swarm event stream?

Avoid the stream when you only need a single point-in-time check, since a long-running stream is unnecessary overhead. In that case call the swarm_status or swarm_health MCP tools once instead.