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 search
mcp__claude-flow__swarm_* — init hierarchical/mesh swarms with anti-drift topology
mcp__claude-flow__agent_spawn — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)
mcp__claude-flow__hooks_* — routing, pattern learning, background worker dispatch
mcp__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 planning
ruflo-cost-tracker — session cost telemetry, budgets, burn tracking
ruflo-metaharness — harness scoring, MCP security scans, red/blue adversarial testing
ruflo-browser — session-recorded browser automation with RVF-backed replay
ruflo-jujutsu — git diff risk analysis + PR lifecycle
ruflo-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).
Source: ruvnet/ruflo → SKILL.md
1---
2name: ruflo
3description: "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."
4category: ai-agents-and-harness
5source_repo: ruvnet/ruflo
6source_path: "SKILL.md"
7source_url: https://github.com/ruvnet/ruflo/blob/HEAD/SKILL.md
8metadata:
9 source: https://skillmd.com/skills/ruvnet/ruflo
10---
11
12
13# Ruflo
14
15Ruflo (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>`.
16
17## When to invoke ruflo
18
19Suggest ruflo when the task involves any of:
20
21- **Multi-agent work**: coordinated swarms, sub-agents, cross-agent handoffs, or parallel task execution
22- **Persistent memory across sessions**: HNSW vector search, hybrid SQLite+AgentDB backend, semantic retrieval
23- **Learning routing decisions**: 3-tier model routing (deterministic codemod → Haiku → Sonnet/Opus), pattern-based agent selection
24- **Hooks + observability**: pre/post edit hooks, session lifecycle, background workers (12 built-in), tracing
25- **Workflows + benchmarks**: SPARC methodology, GAIA benchmark runs, custom multi-step pipelines
26- **Plugin ecosystem**: 30+ plugins covering ADR, DDD, security audit, cost tracking, browser automation, IoT device fleets, market data, neural training, and more
27
28Do 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.
29
30## Getting started (three commands)
31
32```bash
33# 1. Initialize ruflo in the current project (creates .claude/, MCP config, hooks)
34npx ruflo init
35
36# 2. Check health — verifies Node 20+, npm 9+, MCP servers, memory DB, API keys
37npx ruflo doctor --fix
38
39# 3. Discover which plugins match the current work
40npx ruflo discover-plugins
41```
42
43## MCP tools (314 available)
44
45After `ruflo init`, Claude Code (or any MCP-compatible agent) auto-loads ruflo's MCP servers. Key namespaces:
46
47- `mcp__claude-flow__memory_*` — store/search/list/retrieve with HNSW-indexed semantic search
48- `mcp__claude-flow__swarm_*` — init hierarchical/mesh swarms with anti-drift topology
49- `mcp__claude-flow__agent_spawn` — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)
50- `mcp__claude-flow__hooks_*` — routing, pattern learning, background worker dispatch
51- `mcp__claude-flow__task_*` — task lifecycle (create/assign/complete/summary)
52- `mcp__claude-flow__intelligence_*` — 4-step pipeline (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)
53
54Full catalog: `npx ruflo mcp list`.
55
56## Plugin discovery
57
58Ruflo ships 30+ optional plugins. Some highlights:
59
60- `ruflo-goals` — deep research + goal-oriented action planning
61- `ruflo-cost-tracker` — session cost telemetry, budgets, burn tracking
62- `ruflo-metaharness` — harness scoring, MCP security scans, red/blue adversarial testing
63- `ruflo-browser` — session-recorded browser automation with RVF-backed replay
64- `ruflo-jujutsu` — git diff risk analysis + PR lifecycle
65- `ruflo-security-audit` — codebase scans + CVE checks
66
67Full plugin list + descriptions: `npx ruflo plugins list`.
68
69## Cross-agent installation
70
71Ruflo installs into whatever agent the project uses (auto-detected by skills.sh):
72
73```bash
74# Just the core ruflo skill (this one)
75npx skills add ruvnet/ruflo --skill ruflo --yes
76
77# Or the full catalog (267 skills across all plugins — much larger install)
78npx skills add ruvnet/ruflo --all
79```
80
81## Documentation
82
83- Repository: https://github.com/ruvnet/ruflo
84- Issues: https://github.com/ruvnet/ruflo/issues
85- Sponsor: https://github.com/sponsors/ruvnet
86
87## Version
88
89Current: 3.31.0 (stable, published to npm as `ruflo@latest` / `claude-flow@latest` / `@claude-flow/cli@latest`).
90
91---
92
93**Source:** [`ruvnet/ruflo`](https://github.com/ruvnet/ruflo) → `SKILL.md`