ruflo-swarm

Reviewed at commit 13af5f1

Caution: Its skills pre-approve Bash and have Claude run the unpinned npm package @claude-flow/cli@latest through npx, so each new version runs without asking.

Agent teams, swarm coordination, Monitor streams, and worktree isolation — wraps 4 swarm_* + 8 agent_* MCP tools (12 total) plus 6 topologies (hierarchical /…

Made by
ruvnet
What we checked

Opens a live swarm pane with agent tiles, topology, tasks, claims, cost and router picks, read from ruflo's files under .claude-flow and from Claude Code's own agent activity; its buttons run the ruflo CLI, asking twice for destructive ones. By default it appends accepted decisions from a ruflo-console ADR digest file in the project to subagent prompts, and shows short toasts when a subagent fails or keeps failing.

Review details

Static review of the source at the pinned commit; not run. Delta review of the changes since 45bf52c; the rest carries over from the review at that commit. The only change is a new "repository" field in plugin.json; hook code and prompt files are unchanged. Registers session.start, ui.render (PromptHint, Pane), ui.close, command.run (ruflo, ruflo-console, ruflo-swarm-* aliases, ruflo-swarm:watch), turn.start, turn.complete, agent.spawn, tool.call and, only with the audit option on, a wildcard '*' hook. Runtime calls: $.fs.read and $.fs.stat on fixed project paths (.claude-flow/swarm, agents, tasks, claims, hive-mind, ruos, console/adr-digest.json, console/toast-prefs.json and .swarm/state.json; the hive-mind token is not read), $.fs.exists and $.fs.write only for the shared toast policy, which rewrites .claude-flow/console/toasts/swarm.jsonl (at most 60 masked one-line digests) and only when .claude-flow/console already exists, $.store get/set (pane selection and last router pick), $.session.usage, $.session.version, $.agent.list, $.clock timers, $.ui.* (pane, toasts, log), $.prompt.fill (suggested command put in the prompt box, not run) and $.process.run. $.process.run is used for pane buttons and the opt-in audit flush only, with a fixed argv prefix (default npx --offline -y @claude-flow/cli@latest, cached package only; the cli option can switch to npx without --offline, ruflo or claude-flow), fixed actions, ids checked by regex and one JSON argument as an argv element, never a shell string; stop, steal and hand off need a second press within 30 seconds. The injectAdrs option (on by default) reads .claude-flow/console/adr-digest.json (16 KB max, under a day old, exact console shape, hidden characters refused) and appends up to 8 ADR lines, each quoted and framed as data, to every spawned subagent's prompt; the file can come from a cloned repository, so its text reaches subagents framed but unverified. The tool.call hook only observes and never blocks or changes calls. The monitor-stream skill and /ruflo-swarm:watch run scripts/swarm-watch.mjs through the Monitor tool, which polls npx -y @claude-flow/cli@latest swarm status every 10 seconds; the swarm-init and monitor-stream skills pre-approve Bash(npx *) and tell Claude to run npx @claude-flow/cli@latest. The @claude-flow/cli package and ruflo-core MCP tools were not reviewed.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events

Agent teams, swarm coordination, Monitor streams, and worktree isolation — wraps 4 swarm_* + 8 agent_* MCP tools (12 total) plus 6 topologies (hierarchical / mesh / hierarchical-mesh / ring / star / adaptive). With Claude Code function hooks on (early access), a live swarm pane: agent tiles lit by reads and writes, topology, task and claims board, cost, router pick and hive-mind votes, with buttons that act through the ruflo CLI

Made this mod? Add a badge to your README

modsforClaude badge for ruflo-swarm

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/ruflo-swarm.svg)](https://modsforclaude.com/mods/ruflo-swarm/)

← All mods