🌊 The leading agent meta-harness for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning swarm intelligence, RAG integration, and native Claude Code / Codex Integration
Ruflo is a TypeScript multi-agent orchestration harness that extends Claude Code with coordinated swarm behavior, persistent memory, and federated agent communication. Running `npx ruflo init` installs a full runtime into a project, including 98 specialized agents, over 60 CLI commands, 30 skills, an MCP server, and a hooks layer that automatically routes tasks in the background without requiring manual configuration. A lighter Claude Code plugin path provides slash commands and agent definitions without modifying the workspace. Agents self-organize into swarms, share a learning loop that improves routing from completed tasks, and retain memory across sessions using a Rust-based engine with vector embeddings. Federation support lets agents on separate machines exchange context without exposing raw data, which is the standout capability for teams working across trust boundaries. A companion Codex plugin is also published to npm. Developers building multi-step autonomous coding workflows, engineering teams coordinating distributed AI processes, and individuals who want persistent context in Claude Code sessions are the primary audience.
Claimed agent orchestration platform for Claude with multi-agent swarms and enterprise features.
- ✓Open-source license (MIT)
- ✓Actively maintained (<30d)
- ✓Healthy fork ratio
- ✓Clear description
- ✓Topics declared
- ✓Mature repo (>1y old)
git clone https://github.com/ruvnet/ruflo && cp ruflo/*.md ~/.claude/agents/24 items in this repository
Agent skill for adaptive-coordinator - invoke with $agent-adaptive-coordinator
Agent skill for agentic-payments - invoke with $agent-agentic-payments
Agent skill for analyze-code-quality - invoke with $agent-analyze-code-quality
Agent skill for arch-system-design - invoke with $agent-arch-system-design
Agent skill for automation-smart-agent - invoke with $agent-automation-smart-agent
Agent skill for base-template-generator - invoke with $agent-base-template-generator
Agent skill for benchmark-suite - invoke with $agent-benchmark-suite
Agent skill for byzantine-coordinator - invoke with $agent-byzantine-coordinator
Agent skill for code-goal-planner - invoke with $agent-code-goal-planner
Agent skill for code-review-swarm - invoke with $agent-code-review-swarm
Agent skill for collective-intelligence-coordinator - invoke with $agent-collective-intelligence-coordinator
Agent skill for consensus-coordinator - invoke with $agent-consensus-coordinator
Agent skill for coordinator-swarm-init - invoke with $agent-coordinator-swarm-init
Agent skill for crdt-synchronizer - invoke with $agent-crdt-synchronizer
Agent skill for dev-backend-api - invoke with $agent-dev-backend-api
Subagents overview
<div align="center">
[](https://cognitum.one/agentic-engineering)
[](https://flo.ruv.io/)
[](https://goal.ruv.io/)
[](https://goal.ruv.io/agents)
[](https://www.npmjs.com/package/ruflo)
[](https://github.com/ruvnet/ruflo/blob/main/data/clone-data.proof.json)
[](https://github.com/ruvnet/ruflo/blob/main/data/clone-data.ledger.json)
[](https://github.com/ruvnet/claude-flow)
[](https://opensource.org/licenses/MIT)
[](https://github.com/ruvnet/claude-flow)
[](https://www.npmjs.com/package/@claude-flow/codex)
[](https://github.com/ruvnet/ruvector)
# Ruflo
**Multi-agent AI harness for Claude Code and Codex**
</div>
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`](https://ruv.io), 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`](https://cognitum.one/?RuFlo) agentic architecture, running a supercharged Rust based AI engine, embeddings, memory, and plugin system.
### What Ruflo Does
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.
---
## 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 | **No** (`memory_store`, `swarm_init`, etc. unavailable to Claude) | 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)
```bash
# 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 only. The Ruflo MCP server is NOT registered, so `memory_store`, `swarm_init`, `agent_spawn`, etc. won't be callable from Claude. For the full loop, use Path B below.
<details>
<summary><strong>🔌 All 33 plugins</strong></summary>
#### Core & Orchestration
| Plugin | What it does |
|--------|-------------|
| [**ruflo-core**](plugins/ruflo-core/README.md) | Foundation — server, health checks, plugin discovery |
| [**ruflo-swarm**](plugins/ruflo-swarm/README.md) | Coordinate multiple agents as a team |
| [**ruflo-autopilot**](plugins/ruflo-autopilot/README.md) | Let agents run autonomously in a loop |
| [**ruflo-loop-workers**](plugins/ruflo-loop-workers/README.md) | Schedule background tasks on a timer |
| [**ruflo-workflows**](plugins/ruflo-workflows/README.md) | Reusable multi-step task templates |
| [**ruflo-federation**](plugins/ruflo-federation/README.md) | Agents on different machines collaborate securely |
#### Memory & Knowledge
| Plugin | What it does |
|--------|-------------|
| [**ruflo-agentdb**](plugins/ruflo-agentdb/README.md) | Fast vector database for agent memory |
| [**ruflo-rag-memory**](plugins/ruflo-rag-memory/README.md) | Smart retrieval — hybrid search, graph hops, diversity ranking |
| [**ruflo-rvf**](plugins/ruflo-rvf/README.md) | Save and restore agent memory across sessions |
| [**ruflo-ruvector**](plugins/ruflo-ruvector/README.md) | [`ruvector`](https://npmjs.com/package/ruvector) — GPU-accelerated search, Graph RAG, 103 tools |
| [**ruflo-knowledge-graph**](plugins/ruflo-knowledge-graph/README.md) | Build and traverse entity relationship maps |
#### Intelligence & Learning
| Plugin | What it does |
|--------|-------------|
| [**ruflo-intelligence**](plugins/ruflo-intelligence/README.md) | Agents learn from past successes and get smarter |
| [**ruflo-graph-intelligence**](plugins/ruflo-graph-intelligence/) | Sublinear graph reasoning — PageRank, delta updates, complexity-aware execution (ADR-123) |
| [**ruflo-daa**](plugins/ruflo-daa/README.md) | Dynamic agent behavior and cognitive patterns |
| [**ruflo-ruvllm**](plugins/ruflo-ruvllm/README.md) | Run local LLMs (Ollama, etc.) with smart routing |
| [**ruflo-goals**](plugins/ruflo-goals/README.md) | Break big goals into plans and track progress |
#### Code Quality & Testing
| Plugin | What it does |
|--------|-------------|
| [**ruflo-testgen**](plugins/ruflo-testgen/README.md) | Find missing tests and generate them automatically |
| [**ruflo-browser**](plugins/ruflo-browser/README.md) | Automate browser testing with Playwright |
| [**ruflo-jujutsu**](plugins/ruflo-jujutsu/README.md) | Analyze git diffs, score risk, suggest reviewers |
| [**ruflo-docs**](plugins/ruflo-docs/README.md) | Generate and maintain documentation automatically |
#### Security & Compliance
| Plugin | What it does |
|--------|-------------|
| [**ruflo-security-audit**](plugins/ruflo-security-audit/README.md) | Scan for vulnerabilities and CVEs |
| [**ruflo-aidefence**](plugins/ruflo-aidefence/README.md) | Block prompt injection, detect PII, safety scanning |
#### Architecture & Methodology
| Plugin | What it does |
|--------|-------------|
| [**ruflo-adr**](plugins/ruflo-adr/README.md) | Track architecture decisions with a living record |
| [**ruflo-ddd**](plugins/ruflo-ddd/README.md) | Scaffold domain-driven design — contexts, aggregates, events |
| [**ruflo-sparc**](plugins/ruflo-sparc/README.md) | Guided 5-phase development methodology with quality gates |
#### DevOps & Observability
| Plugin | What it does |
|--------|-------What people ask about ruflo
What is ruvnet/ruflo?
+
ruvnet/ruflo is subagents for the Claude AI ecosystem. 🌊 The leading agent meta-harness for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning swarm intelligence, RAG integration, and native Claude Code / Codex Integration It has 59.2k GitHub stars and was last updated today.
How do I install ruflo?
+
You can install ruflo by cloning the repository (https://github.com/ruvnet/ruflo) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is ruvnet/ruflo safe to use?
+
Our security agent has analyzed ruvnet/ruflo and assigned a Trust Score of 73/100 (tier: OK). See the full breakdown of passed checks and flags on this page.
Who maintains ruvnet/ruflo?
+
ruvnet/ruflo is maintained by ruvnet. The last recorded GitHub activity is from today, with 638 open issues.
Are there alternatives to ruflo?
+
Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.
Deploy ruflo to your cloud
Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.
Maintain this repo? Add a badge to your README
Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.
[](https://claudewave.com/repo/ruvnet-ruflo)<a href="https://claudewave.com/repo/ruvnet-ruflo"><img src="https://claudewave.com/api/badge/ruvnet-ruflo" alt="Featured on ClaudeWave: ruvnet/ruflo" width="320" height="64" /></a>More Subagents
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
The agent that grows with you
Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Production-ready platform for agentic workflow development.
The agent engineering platform.
🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.