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:

• mcpclaude-flowmemory_* — store/search/list/retrieve with HNSW-indexed semantic search
• mcpclaude-flowswarm_* — init hierarchical/mesh swarms with anti-drift topology
• mcpclaude-flowagent_spawn — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)
• mcpclaude-flowhooks_* — routing, pattern learning, background worker dispatch
• mcpclaude-flowtask_* — task lifecycle (create/assign/complete/summary)
• mcpclaude-flowintelligence_* — 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

• Repository: https://github.com/ruvnet/ruflo
• Issues: https://github.com/ruvnet/ruflo/issues
• Sponsor: https://github.com/sponsors/ruvnet

Version

Current: 3.31.0 (stable, published to npm as ruflo@latest / claude-flow@latest / @claude-flow/cli@latest).