Ruflo

Multi-agent AI orchestration for Claude Code

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.

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.

What Ruflo Does

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.

---

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
/plugin install ruflo-federation@ruflo

All 32 plugins

Core & Orchestration

Plugin	What it does
ruflo-core	Foundation — server, health checks, plugin discovery
ruflo-swarm	Coordinate multiple agents as a team
ruflo-autopilot	Let agents run autonomously in a loop
ruflo-loop-workers	Schedule background tasks on a timer
ruflo-workflows	Reusable multi-step task templates
ruflo-federation	Agents on different machines collaborate securely

Memory & Knowledge

Plugin	What it does
ruflo-agentdb	Fast vector database for agent memory
ruflo-rag-memory	Smart retrieval — hybrid search, graph hops, diversity ranking
ruflo-rvf	Save and restore agent memory across sessions
ruflo-ruvector	ruvector — GPU-accelerated search, Graph RAG, 103 tools
ruflo-knowledge-graph	Build and traverse entity relationship maps

Intelligence & Learning

Plugin	What it does
ruflo-intelligence	Agents learn from past successes and get smarter
ruflo-daa	Dynamic agent behavior and cognitive patterns
ruflo-ruvllm	Run local LLMs (Ollama, etc.) with smart routing
ruflo-goals	Break big goals into plans and track progress

Code Quality & Testing

Plugin	What it does
ruflo-testgen	Find missing tests and generate them automatically
ruflo-browser	Automate browser testing with Playwright
ruflo-jujutsu	Analyze git diffs, score risk, suggest reviewers
ruflo-docs	Generate and maintain documentation automatically

Security & Compliance

Plugin	What it does
ruflo-security-audit	Scan for vulnerabilities and CVEs
ruflo-aidefence	Block prompt injection, detect PII, safety scanning

Architecture & Methodology

Plugin	What it does
ruflo-adr	Track architecture decisions with a living record
ruflo-ddd	Scaffold domain-driven design — contexts, aggregates, events
ruflo-sparc	Guided 5-phase development methodology with quality gates

DevOps & Observability

Plugin	What it does
ruflo-migrations	Manage database schema changes safely
ruflo-observability	Structured logs, traces, and metrics in one place
ruflo-cost-tracker	Track token usage, set budgets, get cost alerts

Extensibility

Plugin	What it does
ruflo-wasm	Run sandboxed WebAssembly agents
ruflo-plugin-creator	Scaffold, validate, and publish your own plugins

Domain-Specific

Plugin	What it does
ruflo-iot-cognitum	IoT device management — trust scoring, anomaly detection, fleets
ruflo-neural-trader	neural-trader — AI trading with 4 agents, backtesting, 112+ tools
ruflo-market-data	Ingest market data, vectorize OHLCV, detect patterns

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
📡 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	32 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

Agent Federation — Slack for Agents

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 status

See 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-federation

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)

---

Documentation

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

---

Support

Resource	Link
Documentation	User Guide
Issues & Bugs	GitHub Issues
Enterprise	ruv.io
Community	Agentics Foundation Discord
Powered by	Cognitum.one

License

MIT - RuvNet