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)