ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-swarm@ruflo
Open the repo

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

The Live swarm pane section of the ruflo-swarm README: a tile per agent colored by state, the topology, tasks, hive-mind votes, cost and context, buttons that act through the ruflo CLI with a second press for stop, steal and hand off, the /ruflo swarm commands, and the options. The README has no picture of the pane itself.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • ui.renderDraws into the sessionPromptHintPane
  • ui.closeWhen its pane closes
  • command.runWhen you run its slash command/ruflo-swarm:watch
  • turn.startWhen Claude starts a turn
  • turn.completeWhen a turn ends
  • agent.spawnWhen a subagent starts
  • tool.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

Same repo on other shelves

Skills

  1. 5783rufloruvnet/ruflo4.2k
  2. 9353swarm-orchestrationruvnet/ruflo2.1k
  3. 11258agent-arch-system-designruvnet/ruflo1.4k

MCP servers

  1. 7Claude Flowruvnet/ruflo🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated81.3k

Marketplaces

  1. 9ruvnet/rufloruvnet/ruflo🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated81.8k

Other mods in Workflow

artifact-dashboardDannyMac180Draws a line above the prompt with the cards per column on a shared Kanban board, a claude.ai artifact that every session on the project reads and writes.mode-registryDannyMac180Shows the active mode as a label in the prompt footer, and /mode opens a picker above the prompt with a button for each mode that other plugins offer.pr-statusomeerdvrnDraws the CI checks of the current branch's pull request above the prompt, counted by state, updates them while they run, and toasts when CI passes or fails.snippetsomeerdvrnAdds Linear issues to the prompt typeahead, colors paths, tickets, and secrets as you type, shows pasted image thumbnails, and expands ;;snippets.open-loopscharlie947Opens a pane that lists every ask you make in a session, and Claude can tick one off only with proof.sessions-bandcharlie947Draws a bar above the prompt that lists your other open Claude Code sessions, with an Ask button for each.quickbarmishgoldenbergDraws one line above the prompt with the live context percent and a button for each claude-mods panel you have installed.notifymishgoldenbergKeeps a notification inbox and raises an OS notification when a long turn ends, a subagent or task finishes, Claude asks something, or an approval waits 15s.activitymishgoldenbergOpens a pane of what Claude is doing this second: thinking, the command it runs and for how long, an approval waiting on you, its subagents, and its todo plan.toolboxmishgoldenbergOpens a pane of every tool Claude can use, built-in and MCP grouped by server, in plain language, with how often each was used and suggestions for this project.command-hubmishgoldenbergOpens a pane of built-in commands you may be missing, each with when to use it, a searchable list of everything installed, and a form for a new slash command.vibe-annotationsRaphaelRegnierDraws new browser annotations from your localhost app in a band above the prompt, and hands them to Claude as one prompt when you press Implement.
All 396 in Workflow