Ruflo is the execution layer around Claude Code and Codex that turns a single AI assistant into a coordinated intelligence platform. OneDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/ruvnet/ruflo/llms.txt
Use this file to discover all available pages before exploring further.
npx ruflo@latest init installs 100+ specialized agents, a self-learning memory system, 27 lifecycle hooks, and an MCP server with 313 tools — so agents don’t just run, they collaborate, remember, and improve over every session.
Quickstart
Deploy your first agent swarm in under 5 minutes with a single command.
Installation
Install via npx, npm global, or as a Claude Code plugin. All platforms supported.
Core Concepts
Understand agents, swarms, memory, and hooks — the building blocks of Ruflo.
CLI Reference
Full reference for all 26 commands and 140+ subcommands.
What Ruflo Does
Agent = Model + Harness. The model writes; the harness gives it tools, memory, loops, sandboxes, and controls so it can actually work. Ruflo is the harness.Ruflo wraps Claude Code and Codex with everything they need to tackle complex, long-running engineering tasks autonomously:
100+ Agents
Specialized agents for coding, testing, security, documentation, architecture, and more — each optimized for its role.
Swarm Coordination
Hierarchical, mesh, ring, and star topologies with Raft/BFT/Gossip consensus algorithms.
Self-Learning Memory
HNSW-indexed vector memory with 150x–12,500x faster search. Agents remember and improve across sessions.
313 MCP Tools
Full Model Context Protocol server. Works natively with Claude Code, Codex, Cursor, Windsurf, and more.
Lifecycle Hooks
27 hooks and 12 background workers automatically route tasks, learn patterns, and coordinate agents.
Plugin System
35-plugin marketplace. Build your own with the fluent
PluginBuilder API.Get Started
Use Claude Code normally
The hooks system automatically routes tasks, coordinates agents, and stores successful patterns. No new workflow required.
Explore the Docs
Claude Code Integration
Connect Ruflo to Claude Code via MCP and slash commands for the full agent loop.
Codex Integration
Use Ruflo as an orchestration layer for OpenAI Codex workflows.
Plugin System
Install from the 35-plugin marketplace or build your own with the fluent builder API.
MCP Tools Reference
Browse all 313 MCP tools across coordination, memory, monitoring, and GitHub categories.
Security Guide
Enterprise-grade security: input validation, command sandboxing, CVE monitoring, and more.
Federation
Connect agents across machines for secure cross-node collaboration.