Deploy 16 specialized agent roles + custom types in coordinated swarms with self-learning capabilities, fault-tolerant consensus, and enterprise-grade security.
Why Ruflo? Claude Flow is now Ruflo — named by Ruv, who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the Ruv. The "flo" is the flow. Underneath, WASM kernels written in Rust power the policy engine, embeddings, and proof system.
Ruflo is a comprehensive AI agent orchestration framework that transforms Claude Code into a powerful multi-agent development platform. It enables teams to deploy, coordinate, and optimize specialized AI agents working together on complex software engineering tasks.
Self-Learning / Self-Optimizing Agent Architecture
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.
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@rufloAll 20 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 |
| ruflo-goals | GOAP planning, deep research, long-horizon tracking |
# 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# Add Ruflo as an MCP server in Claude Code
claude mcp add ruflo -- npx -y @claude-flow/cli@latest| 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 | 20 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
| Capability | Claude Code Alone | + Ruflo |
|---|---|---|
| Agent Collaboration | Isolated, no shared context | Swarms with shared memory and consensus |
| Coordination | Manual orchestration | Queen-led hierarchy (Raft, Byzantine, Gossip) |
| Memory | Session-only | HNSW vector memory with sub-ms retrieval |
| Learning | Static behavior | SONA self-learning with pattern matching |
| Task Routing | You decide | Intelligent routing (89% accuracy) |
| Background Workers | None | 12 auto-triggered workers |
| LLM Providers | Anthropic only | 5 providers with failover |
| Security | Standard | CVE-hardened with AIDefence |
Architecture overview
User --> Claude Code / CLI
|
v
Orchestration Layer
(MCP Server, Router, 27 Hooks)
|
v
Swarm Coordination
(Queen, Topology, Consensus)
|
v
100+ Specialized Agents
(coder, tester, reviewer, architect, security...)
|
v
Memory & Learning
(AgentDB, HNSW, SONA, ReasoningBank)
|
v
LLM Providers
(Claude, GPT, Gemini, Cohere, Ollama)
Full documentation including architecture, configuration, CLI reference, API usage, plugin development, and advanced topics:
User Guide -- Complete reference documentation
| Section | Topics |
|---|---|
| Quick Start | Installation, prerequisites, install profiles |
| Core Features | MCP tools, agents, memory, neural learning |
| Intelligence & Learning | Hooks, workers, SONA, model routing |
| Swarm & Coordination | Topologies, consensus, hive mind |
| Security | AIDefence, CVE remediation, validation |
| Ecosystem | RuVector, agentic-flow, Flow Nexus |
| Configuration | Environment variables, config schema |
| Plugin Marketplace | Browse and install plugins |
| Resource | Link |
|---|---|
| Documentation | User Guide |
| Issues & Bugs | GitHub Issues |
| Enterprise | ruv.io |
| Community | Agentics Foundation Discord |
| Powered by | Cognitum.one |
MIT - RuvNet