All shelves / Mods / Workflow
ruflo-swarm
By ruvnet
ruflo-swarm is a Claude Code workflow mod by ruvnet.
Draws a live pane of a ruflo swarm beside the transcript: a tile per agent and subagent, the topology, tasks, votes, cost, and buttons that act through the CLI.
Draws
Install
The marketplace name is ruflo.
/plugin marketplace add ruvnet/ruflo /plugin install ruflo-swarm@ruflo
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.3.7
- License
- MIT
- Repo stars
- 80064
- Last change
- 2026-10-11
What it can reach
- Draws in the session
- Sees tool calls
- Reads usage or context figures
- Runs a command when you press
The author calls the pane early access. It needs Claude Code function hooks on, CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 or the engine's own rollout; without them, the plugin's commands, skills, and agents load as before. Open it with /ruflo swarm pane, through ruflo-console's /ruflo, or /ruflo-swarm:watch. Stop, steal, and hand off ask for a second press. The cli option defaults to npx-offline, which never touches the network. injectAdrs is on by default and adds an attached mission's accepted ADRs, masked and capped, to spawned subagents' prompts; injectSpawnContext and audit are off by default. Under ruflo-mods' modTrust refuse-risky, add ruflo-swarm@ruflo to modTrustAllow to keep it.
The marketplace name is ruflo. Add ruvnet/ruflo. The marketplace holds 47 plugins, ruflo-console and ruflo-mods among them. This one installs on its own, and its commands, skills, and agents for agent teams load even without the pane. Watching and steering a team of agents is why this page files it under workflow. agentpane draws a side pane of every subagent, with its current tool, tokens, model, and effort. mission-control-h-zahran opens a side pane of robots, one for the main loop and one per subagent. This one draws ruflo's swarm as ruflo wrote it to disk, next to Claude Code's own subagents and teammates: a tile per agent whose color says idle, working, blocked, done, or failed, with a word beside it, blue while it reads and yellow while it writes, the topology, task claims, hive-mind votes, and the router's last pick. A figure that is not on disk shows as n/a, not zero. Its buttons claim, steal, hand off, stop, re-route, or vote through the ruflo CLI, then re-read the disk and say whether the change shows there. In the source, the pane is a Pane render, with a hint in the PromptHint slot and toasts.
Demo

What it hooks into
session.startWhen a session startsui.renderDraws into the sessionPromptHintPaneui.closeWhen its pane closescommand.runWhen you run its slash command/ruflo-swarm:watchturn.startWhen Claude starts a turnturn.completeWhen a turn endsagent.spawnWhen a subagent startstool.callAround a tool call, where it can hold one*A Claude Code event
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- ruvnet
- Category
- Workflow
- Marketplace
- ruflo
- Repo
- ruvnet/ruflo
- Folder
- plugins/ruflo-swarm
- Version
- 0.3.7
- License
- MIT
- Repo stars
- 80064
- Last change
- 2026-10-11
- Language
- TypeScript
- Files
- 48