

Ruflo
Self-learning multi-agent AI orchestration for Claude Code
Ruflo turns Claude Code into a self-optimizing multi-agent platform. Deploy specialized AI agents in coordinated swarms that learn from every task, build persistent vector memory, and automate workflows -- with fault-tolerant consensus and intelligent routing that gets smarter over time.
User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Providers
^ |
+---- Learning Loop <-------+
New to Ruflo? You don't need to learn 314 MCP tools or 26 CLI commands. After init, just use Claude Code normally -- the hooks system automatically routes tasks, learns from successful patterns, and coordinates agents in the background.
Quick Start
Claude Code Plugin (Recommended)
Install Ruflo as a native Claude Code plugin -- adds skills, commands, agents, and MCP tools directly:
# Add the marketplace
/plugin marketplace add ruvnet/ruflo
# Install core + any plugins you need
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-autopilot@ruflo
All 19 plugins
| Plugin | What it adds |
|---|
| ruflo-core | MCP server, /status, /doctor, plugin discovery, base agents |
| ruflo-swarm | Swarm coordination, Monitor streams, worktree isolation |
| ruflo-autopilot | Autonomous /loop completion with learning and prediction |
| ruflo-intelligence | Self-learning SONA patterns, trajectory learning, model routing |
| ruflo-agentdb | AgentDB controllers, HNSW vector search, RuVector embeddings |
| ruflo-aidefence | AI safety scanning, PII detection, prompt injection defense |
| ruflo-browser | Playwright browser automation for testing and scraping |
| ruflo-jujutsu | Git diff analysis, risk scoring, reviewer recommendations |
| ruflo-wasm | Sandboxed WASM agent creation and gallery sharing |
| ruflo-workflows | Workflow templates, orchestration, lifecycle management |
| ruflo-daa | Dynamic Agentic Architecture, cognitive patterns |
| ruflo-ruvllm | Local LLM inference, MicroLoRA, multi-provider chat |
| ruflo-rvf | RVF portable memory, session persistence, transfer |
| ruflo-loop-workers | Background /loop workers, CronCreate scheduling |
| ruflo-security-audit | Security scanning, CVE checks, dependency audit |
| ruflo-rag-memory | Memory bridge, simple store/search/recall interface |
| ruflo-testgen | Test gap detection, TDD workflow, tester agent |
| ruflo-docs | Doc generation, drift detection, docs-writer agent |
| ruflo-plugin-creator | Scaffold, validate, and publish new plugins |
CLI Install
# One-line install
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
# Or via npx
npx ruflo@latest init --wizard
# Or install globally
npm install -g ruflo@latest
MCP Server
# Add Ruflo as an MCP server in Claude Code
claude mcp add ruflo -- npx -y @claude-flow/cli@latest
What You Get
| Capability | Description |
|---|
| 🤖 100+ Agents | Specialized agents for coding, testing, security, docs, architecture |
| 🐝 Swarm Coordination | Hierarchical, mesh, and adaptive topologies with consensus |
| 🧠 Self-Learning | SONA neural patterns, ReasoningBank, trajectory learning |
| 💾 Vector Memory | HNSW-indexed AgentDB with 150x-12,500x faster search |
| ⚡ Background Workers | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |
| 🧩 Plugin Marketplace | 19 native Claude Code plugins + 20 npm plugins |
| 🔌 Multi-Provider | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
| 🛡️ Security | AIDefence, input validation, CVE remediation, path traversal prevention |
Claude Code: With vs Without Ruflo