Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

monitor-stream — Claude Code skill: live swarm event stream

Streams ruflo swarm status changes into your session through the Monitor tool, so you see agent counts shift instead of polling the CLI by hand.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add ruvnet/ruflo --skill monitor-stream -a claude-code
Open on GitHub

What monitor-stream does

The skill wires the Monitor tool to a small script and lets it feed the session. Your agent runs node "${CLAUDE_PLUGIN_ROOT}/scripts/swarm-watch.mjs" and gets an NDJSON line whenever the swarm changes: swarm.snapshot, swarm.changed or swarm.error. Every stdout line fires a notification, so nothing sits waiting in a loop.

ruflo's CLI has no swarm watch, so the script polls swarm status --format json on its own and prints a line only on a change. Add --interval 5 for faster updates; the floor is 2 s. What arrives is status and agent-count movement. Individual task and memory events stay out of the stream, so don't expect them there.

A one-off check takes a different path: mcp__plugin_ruflo-core_ruflo__swarm_status and mcp__plugin_ruflo-core_ruflo__swarm_health return a single snapshot. The script lives inside the ruflo plugin, which is why the path is built from ${CLAUDE_PLUGIN_ROOT} and the start command is node.

What it helps with

  • watch whether the agent count in a swarm is climbing
  • catch the moment a swarm's status changes
  • get a notification per change instead of re-running status
  • pull a one-shot health snapshot before starting work
  • tell a swarm.error apart from a normal change

Example prompts for the agent

  • Run `node "${CLAUDE_PLUGIN_ROOT}/scripts/swarm-watch.mjs"` through Monitor and show me swarm changes as they land.
  • Start the stream with `--interval 5`, I want to watch the agent count move.
  • Check `swarm_health` once, then switch to the event stream.

How to install monitor-stream

1Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill monitor-stream -a claude-code

2Manually: put the files in place

~/.claude/skills/monitor-stream/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/monitor-stream/

From the same set104

The whole set →
ruflo ruvnet This skill adds multi-agent orchestration, memory, routing, and MCP tools to a project. Use it for swarm tasks and multi-step workflows. Claude Code CX Codex Cursor +1 4,000installs Swarm Orchestration ruvnet Skill for managing agent swarms with parallel execution, dynamic topology, and automatic load balancing. Use when a single agent is not enough and you need to orchestrate specialists of different types. Claude Code CX Codex Cursor +1 2,100installs github-project-management ruvnet Turns issue triage and board upkeep into gh and ruv-swarm calls: labels, subtasks, duplicate lookup. Useful when the tracker holds more tickets than order. Claude Code CX Codex Cursor +1 1,400installs github-workflow-automation ruvnet Automates GitHub Actions with AI agent coordination. Generates optimised pipelines, manages pull requests, analyzes failed runs, and deploys updates with risk assessment. Claude Code CX Codex Cursor +1 1,300installs github-code-review ruvnet Runs a swarm of specialized AI agents to inspect GitHub pull requests for security, performance, and architecture issues. Claude Code CX Codex Cursor +1 1,300installs stream-chain ruvnet Chains sequential agent steps together using streaming JSON flow and provides ready-to-run pipelines. Claude Code CX Codex Cursor +1 1,200installs flow-nexus-swarm ruvnet Deploy cloud-based AI agent swarms and define event-driven workflows with message queues. Use it to coordinate tasks, inspect runs, and scale a swarm. Claude Code CX Codex Cursor +1 1,200installs performance-analysis ruvnet Detects bottlenecks in Claude Flow swarms, profiles agent operations, and generates reports with actionable optimization recommendations. Claude Code CX Codex Cursor +1 1,200installs

Similar

mantis-plan official google Generates a targeted security review plan based on your threat model and historical findings. Run at the start of a review campaign to map code boundaries and prioritize what to check. Claude Code CX Codex Cursor +1 1,600installs mantis-summarize official google Builds a security-focused codebase map with mantis-summary.md files in each directory. Reduces token overhead during planning and research. Claude Code CX Codex Cursor +1 1,600installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs google-agents-cli-adk-code official Google A reference for the Agent Development Kit API: agent types, tools, callbacks, state and the graph Workflow API. Useful when you are writing agent code, not scaffolding a project. Claude Code CX Codex Cursor +1 511,400installs stitch-loop official google-labs-code Guides agents through iterative website creation with Stitch MCP. The agent reads the baton file, generates UI, integrates the page, and prepares tasks for the next run. Claude Code CX Codex Cursor +1 56,300installs improve shadcn Surveys any codebase in read-only mode and writes self-contained implementation plans for other models to execute. Helps audit bugs, tech debt, and security without touching code. Claude Code CX Codex Cursor +1 37,500installs

Questions about monitor-stream

How do I install monitor-stream in Claude Code?

Run npx skills add ruvnet/ruflo --skill monitor-stream -a claude-code. The skill lands at ~/.claude/skills/monitor-stream/SKILL.md.

What does monitor-stream do?

It streams ruflo swarm state changes into your session through the Monitor tool, one NDJSON line per change, covering status and agent count.

Can I see individual task or memory events in the stream?

No. The script polls swarm status --format json, which returns a swarm summary only. For a point-in-time view use mcp__plugin_ruflo-core_ruflo__swarm_status or mcp__plugin_ruflo-core_ruflo__swarm_health.

Source text

SKILL.md · MIT 
---
name: monitor-stream
description: Stream live swarm events using the Monitor tool for real-time observability
argument-hint: ""
allowed-tools: Bash(npx *) mcp__plugin_ruflo-core_ruflo__swarm_status mcp__plugin_ruflo-core_ruflo__swarm_health Monitor
---
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.

© ruvnet · MIT · ruvnet/ruflo

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor