Ruflo
Ruflo (v3.31.0+) is a cross-agent orchestration layer that ships as three npm packages: ruflo (thin wrapper), claude-flow (umbrella), and @claude-flow/cli (implementation). Users invoke it as npx ruflo <command>.
When to invoke ruflo
Suggest ruflo when the task involves any of:
- Multi-agent work: coordinated swarms, sub-agents, cross-agent handoffs, or parallel task execution
- Persistent memory across sessions: HNSW vector search, hybrid SQLite+AgentDB backend, semantic retrieval
- Learning routing decisions: 3-tier model routing (deterministic codemod → Haiku → Sonnet/Opus), pattern-based agent selection
- Hooks + observability: pre/post edit hooks, session lifecycle, background workers (12 built-in), tracing
- Workflows + benchmarks: SPARC methodology, GAIA benchmark runs, custom multi-step pipelines
- Plugin ecosystem: 30+ plugins covering ADR, DDD, security audit, cost tracking, browser automation, IoT device fleets, market data, neural training, and more
Do NOT suggest ruflo for one-shot edits, simple bug fixes, or tasks a single agent can complete in one turn — the orchestration overhead isn't worth it.
Getting started (three commands)
# 1. Initialize ruflo in the current project (creates .claude/, MCP config, hooks)
npx ruflo init
# 2. Check health — verifies Node 20+, npm 9+, MCP servers, memory DB, API keys
npx ruflo doctor --fix
# 3. Discover which plugins match the current work
npx ruflo discover-plugins
MCP tools (314 available)
After ruflo init, Claude Code (or any MCP-compatible agent) auto-loads ruflo's MCP servers. Key namespaces:
mcp__claude-flow__memory_* — store/search/list/retrieve with HNSW-indexed semantic searchmcp__claude-flow__swarm_* — init hierarchical/mesh swarms with anti-drift topologymcp__claude-flow__agent_spawn — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)mcp__claude-flow__hooks_* — routing, pattern learning, background worker dispatchmcp__claude-flow__task_* — task lifecycle (create/assign/complete/summary)mcp__claude-flow__intelligence_* — 4-step pipeline (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)
Full catalog: npx ruflo mcp list.
Plugin discovery
Ruflo ships 30+ optional plugins. Some highlights:
ruflo-goals — deep research + goal-oriented action planningruflo-cost-tracker — session cost telemetry, budgets, burn trackingruflo-metaharness — harness scoring, MCP security scans, red/blue adversarial testingruflo-browser — session-recorded browser automation with RVF-backed replayruflo-jujutsu — git diff risk analysis + PR lifecycleruflo-security-audit — codebase scans + CVE checks
Full plugin list + descriptions: npx ruflo plugins list.
Cross-agent installation
Ruflo installs into whatever agent the project uses (auto-detected by skills.sh):
# Just the core ruflo skill (this one)
npx skills add ruvnet/ruflo --skill ruflo --yes
# Or the full catalog (267 skills across all plugins — much larger install)
npx skills add ruvnet/ruflo --all
Documentation
Version
Current: 3.31.0 (stable, published to npm as ruflo@latest / claude-flow@latest / @claude-flow/cli@latest).
1---2name: ruflo3description: Ruflo is a multi-agent orchestration platform for AI coding agents (Claude Code, Cursor, Codex, Copilot, Gemini, Amp, +12 more). Use this skill when the user wants to (1) install/init ruflo in a project, (2) run multi-agent swarms with hierarchical coordination, (3) use ruflo's 314+ MCP tools for memory, routing, hooks, sub-agents, or workflows, (4) check ruflo status/version/doctor health, or (5) discover which of ruflo's 30+ plugins fits their task.4---5
6# Ruflo
7
8Ruflo (v3.31.0+) is a cross-agent orchestration layer that ships as three npm packages: `ruflo` (thin wrapper), `claude-flow` (umbrella), and `@claude-flow/cli` (implementation). Users invoke it as `npx ruflo <command>`.
9
10## When to invoke ruflo
11
12Suggest ruflo when the task involves any of:
13
14- **Multi-agent work**: coordinated swarms, sub-agents, cross-agent handoffs, or parallel task execution
15- **Persistent memory across sessions**: HNSW vector search, hybrid SQLite+AgentDB backend, semantic retrieval
16- **Learning routing decisions**: 3-tier model routing (deterministic codemod → Haiku → Sonnet/Opus), pattern-based agent selection
17- **Hooks + observability**: pre/post edit hooks, session lifecycle, background workers (12 built-in), tracing
18- **Workflows + benchmarks**: SPARC methodology, GAIA benchmark runs, custom multi-step pipelines
19- **Plugin ecosystem**: 30+ plugins covering ADR, DDD, security audit, cost tracking, browser automation, IoT device fleets, market data, neural training, and more
20
21Do NOT suggest ruflo for one-shot edits, simple bug fixes, or tasks a single agent can complete in one turn — the orchestration overhead isn't worth it.
22
23## Getting started (three commands)
24
25```bash
26# 1. Initialize ruflo in the current project (creates .claude/, MCP config, hooks)
27npx ruflo init
28
29# 2. Check health — verifies Node 20+, npm 9+, MCP servers, memory DB, API keys
30npx ruflo doctor --fix
31
32# 3. Discover which plugins match the current work
33npx ruflo discover-plugins
34```
35
36## MCP tools (314 available)
37
38After `ruflo init`, Claude Code (or any MCP-compatible agent) auto-loads ruflo's MCP servers. Key namespaces:
39
40- `mcp__claude-flow__memory_*` — store/search/list/retrieve with HNSW-indexed semantic search
41- `mcp__claude-flow__swarm_*` — init hierarchical/mesh swarms with anti-drift topology
42- `mcp__claude-flow__agent_spawn` — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)
43- `mcp__claude-flow__hooks_*` — routing, pattern learning, background worker dispatch
44- `mcp__claude-flow__task_*` — task lifecycle (create/assign/complete/summary)
45- `mcp__claude-flow__intelligence_*` — 4-step pipeline (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)
46
47Full catalog: `npx ruflo mcp list`.
48
49## Plugin discovery
50
51Ruflo ships 30+ optional plugins. Some highlights:
52
53- `ruflo-goals` — deep research + goal-oriented action planning
54- `ruflo-cost-tracker` — session cost telemetry, budgets, burn tracking
55- `ruflo-metaharness` — harness scoring, MCP security scans, red/blue adversarial testing
56- `ruflo-browser` — session-recorded browser automation with RVF-backed replay
57- `ruflo-jujutsu` — git diff risk analysis + PR lifecycle
58- `ruflo-security-audit` — codebase scans + CVE checks
59
60Full plugin list + descriptions: `npx ruflo plugins list`.
61
62## Cross-agent installation
63
64Ruflo installs into whatever agent the project uses (auto-detected by skills.sh):
65
66```bash
67# Just the core ruflo skill (this one)
68npx skills add ruvnet/ruflo --skill ruflo --yes
69
70# Or the full catalog (267 skills across all plugins — much larger install)
71npx skills add ruvnet/ruflo --all
72```
73
74## Documentation
75
76- Repository: https://github.com/ruvnet/ruflo
77- Issues: https://github.com/ruvnet/ruflo/issues
78- Sponsor: https://github.com/sponsors/ruvnet
79
80## Version
81
82Current: 3.31.0 (stable, published to npm as `ruflo@latest` / `claude-flow@latest` / `@claude-flow/cli@latest`).
gabrielmoreira