🌊 The leading agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
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://agentics.org/siliconvalley/?UTM=GH-RuFlo-SV)
<!-- Try Ruflo — the 4 badges first-time visitors actually act on -->
[](https://flo.ruv.io/)
[](https://www.npmjs.com/package/ruflo)
[](https://opensource.org/licenses/MIT)
[](https://github.com/ruvnet/claude-flow)
<!-- Ecosystem strip (collapsed visually with flat-square) -->
[](https://goal.ruv.io/)
[](https://goal.ruv.io/agents)
[](https://github.com/ruvnet/ruvector)
[](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://www.npmjs.com/package/@claude-flow/codex)
# Ruflo
**An agent meta-harness for Claude Code and Codex.**
</div>
> **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.
<details>
<summary><strong>📖 Background — where the name comes from</strong></summary>
> 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.
</details>
---
## 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 35 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 itWhat people ask about ruflo
What is ruvnet/ruflo?
+
ruvnet/ruflo is subagents for the Claude AI ecosystem. 🌊 The leading agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated It has 66.3k 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 839 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 应用开发
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.
The agent engineering platform.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.