ruflo-docs

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

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