Monitor Stream

This streams real-time swarm events using the Monitor tool instead of making you poll status endpoints in a loop. You get NDJSON events for agent spawns, task completions, memory writes, and health checks piped directly to you as they happen. It's built around `npx @claude-flow/cli@latest swarm watch --stream`, with fallback MCP tools for one-shot status checks when you just need a snapshot. The approach makes sense if you're debugging distributed agent behavior or need live observability without hammering the API. There's an ADR backing the design decision, which suggests someone learned this lesson the hard way.

skills.sh installs: 746
GitHub stars: 81.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ruvnet/ruflo --skill monitor-stream --agent claude-code

Installs into .claude/skills of the current project.

Files

Use the Monitor tool to stream swarm events in real time instead of polling:

Run via Monitor: node "${CLAUDE_PLUGIN_ROOT}/scripts/swarm-watch.mjs" (add --interval 5 for faster updates; minimum 2 s)

There is no swarm watch in the ruflo CLI, so this script polls swarm status --format json and prints one NDJSON line when it changes (swarm.snapshot, swarm.changed, swarm.error). It shows status and agent-count changes, not individual task or memory events. Each stdout line triggers a notification.

For one-shot status, use MCP: mcp__plugin_ruflo-core_ruflo__swarm_status or mcp__plugin_ruflo-core_ruflo__swarm_health.

Prefer Monitor over polling swarm status in a loop. See ADR-091 for rationale.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly