ruflo-docs

Deploy 16 specialized agent roles + custom types in coordinated swarms with self-learning capabilities, fault-tolerant consensus, and enterprise-grade security.

Why Ruflo?

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.

Getting into the Flow

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.

---

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

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