Orchestrate 100+ specialized AI agents across machines, teams, and trust boundaries. Ruflo adds coordinated swarms, self-learning memory, federated comms, and enterprise security to Claude Code — so agents don't just run, they collaborate.
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.
One init gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and — with federation — securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.
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@ruflo
/plugin install ruflo-federation@rufloAll 21 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-federation | Zero-trust agent federation, PII pipeline, cross-installation comms |
| 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 |
| 📡 Comms Layer | Zero-trust federation — agents across machines/orgs discover, authenticate, and exchange work securely |
| 🐝 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 | 21 native Claude Code plugins + 21 npm plugins |
| 🔌 Multi-Provider | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
| 🛡️ Security | AIDefence, input validation, CVE remediation, path traversal prevention |
| 🌐 Agent Federation | Cross-installation agent collaboration with zero-trust security |
Your Agent --> [ Remove secrets ] --> [ Sign message ] --> [ Encrypted channel ]
Emails, SSNs, Proves it came No one reads it
keys stripped from you in transit
|
v
Their Agent <-- [ Block attacks ] <-- [ Check identity ] <------+
Stops prompt Rejects forgeries
injection
Audit trail on both sides.
Trust builds over time. Bad behavior = instant downgrade.
Slack gave teams channels. Federation gives agents the same thing — shared workspaces across trust boundaries, where agents on different machines, orgs, or cloud regions can discover each other, prove who they are, and collaborate on tasks.
The difference: some channels are trusted, some aren't. @claude-flow/plugin-agent-federation handles that automatically. Your agents join a federation, get verified via mTLS + ed25519, and start exchanging work — with PII stripped before anything leaves your node and every message auditable. Untrusted agents can still participate at lower privilege: they see discovery info, not your memory. As they prove reliable, trust upgrades. If they misbehave, they get downgraded instantly — no human in the loop required.
You don't configure handshakes or manage certificates. You federation init, federation join, and your agents start talking. The protocol handles identity, the PII pipeline handles data safety, and the audit trail handles compliance.
Federation capabilities
| Capability | How it works | |
|---|---|---|
| 🔒 | Zero-trust federation | Remote agents start untrusted. Identity proven via mTLS + ed25519 challenge-response. No API keys, no shared secrets. |
| 🛡️ | PII-gated data flow | 14-type detection pipeline scans every outbound message. Per-trust-level policies: BLOCK, REDACT, HASH, or PASS. Adaptive calibration reduces false positives. |
| 📊 | Behavioral trust scoring | Formula (0.4×success + 0.2×uptime + 0.2×threat + 0.2×integrity) continuously evaluates peers. Upgrades require history; downgrades are instant. |
| 📋 | Compliance built-in | HIPAA, SOC2, GDPR audit trails as compliance modes. Every federation event produces a structured record searchable via HNSW. |
| 🤝 | 9 MCP tools + 10 CLI commands | Full lifecycle: federation_init, federation_send, federation_trust, federation_audit, and more. |
Example: two teams sharing fraud signals without sharing customer data
# Team A: initialize federation and generate keypair
npx claude-flow@latest federation init
# Team A: join Team B's federation endpoint
npx claude-flow@latest federation join wss://team-b.example.com:8443
# Team A: send a task — PII is stripped automatically before it leaves
npx claude-flow@latest federation send --to team-b --type task-request \
--message "Analyze transaction patterns for account anomalies"
# Team A: check peer trust levels and session health
npx claude-flow@latest federation statusSee issue #1669 for the complete architecture, trust model, and implementation roadmap.
# Claude Code plugin
/plugin install ruflo-federation@ruflo
# Or via CLI
npx claude-flow@latest plugins install @claude-flow/plugin-agent-federationClaude 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