Ruflo

Workflow

Multi-agent harness for Claude Code: 33 plugins for swarms, vector memory, self-learning, and federation.

by ruvnetruvnet/ruflo

Stars78.4k

Forks9.2k

Watchers471

Open issues970

LicenseMIT

Last pushtoday

Install

install

$ /plugin marketplace add ruvnet/ruflo

Update

update

$ /plugin marketplace update ruflo

Then run /reload-plugins. Official marketplaces auto-update at startup.

When to use it

You want to orchestrate many specialized AI agents (swarms) inside Claude Code instead of running one agent at a time
You need persistent, retrievable agent memory across sessions (HNSW-indexed vector store / AgentDB)
You want background workers that auto-trigger tasks like audits, optimizations, and test generation
You need agents to collaborate across machines or trust boundaries (federation with zero-trust auth and PII filtering)

Commands & flags

/plugin install ruflo-core@ruflo: Install the core orchestration plugin from the marketplace.
/plugin install ruflo-swarm@ruflo: Add the swarm plugin for self-organizing multi-agent runs.
/plugin install ruflo-rag-memory@ruflo: Add the HNSW-indexed vector memory (AgentDB) plugin.
npx ruflo@latest init wizard: CLI path: scaffold the full loop (98 agents, hooks, daemon).
claude mcp add ruflo -- npx ruflo@latest mcp start: Register the Ruflo MCP server for the full orchestration toolset.

How to use it

Add the marketplace, then install the plugins you want:

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo

There are 33 plugins across orchestration, memory/knowledge, intelligence/learning, code-quality/testing, security, methodology, and DevOps. The README labels this marketplace path as "lite" (slash commands only, no MCP server). For the full loop (98 agents, MCP server, hooks, daemon) use the CLI path and register the MCP server:

npx ruflo@latest init wizard
claude mcp add ruflo -- npx ruflo@latest mcp start

Why it earns its place

Ruflo turns Claude Code from a single-agent assistant into a multi-agent harness: self-organizing swarms, an HNSW-indexed vector memory (AgentDB) that persists across sessions, self-learning via neural patterns/ReasoningBank, and background workers that auto-run audits, optimizations, and test generation. It ships as a real plugin marketplace (33 plugins) plus an optional MCP server exposing hundreds of orchestration tools, so you adopt only the pieces you need.

Try it

claude

> Initialize a Ruflo swarm to refactor this module: spawn a planner, two coders, and a reviewer with shared memory.