ruvnet/ruflo

Ruflo English · 簡體中文 An agent meta-harness for Claude Code and Codex. 📖 RuFlo Explained — Build an AI Team That Plans, Remembers, Tests, and Improves A 14-chapter guide: from the basic idea to a first useful task, then memory, agent teams, plugins, cost and verification. 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 — the execution layer around Claude Code and Codex that adds 100+ specialized agents, coordinated swarms, self-learning memory, federated comms across machines, and enterprise security guardrails. So agents don't just run, they collaborate. One npx ruflo 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. 📖 Background — where the name comes from 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 working until 3am. Underneath, powered by Cognitum.One agentic architecture, running a supercharged Rust-based AI engine, embeddings, memory, and plugin system. The /ruflo console running in Claude Code — npx ruflo init , restart Claude Code, then /ruflo . Quick Start There are two different install paths with very different surface areas. Pick based on what you need (#1744): Claude Code Plugin CLI install ( npx ruflo init ) What it gives you Slash commands + a few skills + agent definitions per-plugin Full Ruflo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon Files in your workspace Zero .claude/ , .claude-flow/ , CLAUDE.md , helpers, settings MCP server registered Only if ruflo-core is installed (it ships its own .mcp.json ) — most other plugins don't Yes Hooks installed No Yes Best for Try a single plugin's commands without committing to the full install Production use — everything works as documented Path A — Claude Code Plugins (lite, slash commands only) # 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-rag-memory@ruflo /plugin install ruflo-neural-trader@ruflo This adds slash commands and agent definitions. ruflo-core (installed above) does register its own MCP server on install — its tools are callable as mcp__plugin_ruflo-core_ruflo__* (e.g. mcp__plugin_ruflo-core_ruflo__memory_store ), not the bare memory_store / swarm_init / agent_spawn names the CLI-track scaffold uses. Other plugins generally don't ship their own MCP server. For the full loop with the CLI-track tool names, use Path B below. 🔌 All 35 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-graph-intelligence Sublinear graph reasoning — PageRank, delta updates, complexity-aware execution (ADR-123) 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 ruflo-metaharness Grade your agent setup, scan tool configs for security risks, and track changes over time ( guide ) ruflo-arena Competitive ruliology — pit agent strategies against each other in tournaments, hill-climb and co-evolve the winners (ADR-147/148) 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-agent Run agents — local WASM sandbox (rvagent) + Anthropic Claude Managed Agents (cloud) 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 macOS / Linux / WSL / Git-Bash: # One-line install (POSIX shells only — see Windows note below) curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash All platforms (including native Windows PowerShell / cmd): # Interactive setup wizard — runs identically on every platform npx ruflo@latest init wizard # Quick non-interactive init # npx ruflo@latest init # Or install globally npm install -g ruflo@latest 💡 Windows users: the curl ... | bash form needs a POSIX shell (Git-Bash, WSL, MSYS). The npx ruflo@latest init wizard line works natively in PowerShell and cmd. If you hit an 'bash' is not recognized error, use the npx line instead — both end up running the same init flow. MCP Server # Add Ruflo as an MCP server in Claude Code claude mcp add claude-flow -- npx ruflo@latest mcp start 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 — measured ~1.9x faster at N=20k, ~3.2x–4.7x at N=5k vs brute force (recall@10 ~0.99); ANN wins above the crossover, ties/loses at small N. See audit + scripts/benchmark-intelligence.mjs ⚡ Background Workers 12 auto-triggered workers (audit, optimize, testgaps, etc.