https://github.com/ruvnet/ruflo

🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integration, and native Claude Code / Codex Integration
https://github.com/ruvnet/ruflo

agentic-ai agentic-engineering agentic-framework agentic-rag agentic-workflow agents ai-assistant ai-tools anthropic-claude autonomous-agents claude-code claude-code-skills codex huggingface mcp-server model-context-protocol multi-agent multi-agent-systems swarm swarm-intelligence

Last synced: 4 days ago
JSON representation

Host: GitHub
URL: https://github.com/ruvnet/ruflo
Owner: ruvnet
License: mit
Created: 2025-06-02T21:24:20.000Z (12 months ago)
Default Branch: main
Last Pushed: 2026-05-05T20:01:23.000Z (15 days ago)
Last Synced: 2026-05-05T20:04:16.404Z (15 days ago)
Topics: agentic-ai, agentic-engineering, agentic-framework, agentic-rag, agentic-workflow, agents, ai-assistant, ai-tools, anthropic-claude, autonomous-agents, claude-code, claude-code-skills, codex, huggingface, mcp-server, model-context-protocol, multi-agent, multi-agent-systems, swarm, swarm-intelligence
Language: TypeScript
Homepage: https://Cognitum.One
Size: 495 MB
Stars: 43,300
Watchers: 355
Forks: 4,830
Open Issues: 507
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md

Awesome Lists containing this project

awesome-github-projects - ruflo - 🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integration, and native Claude Code / Codex Integration ⭐51,561 `TypeScript` 🔥 (🤖 AI & Machine Learning)
awesome - ruvnet/ruflo - 🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code / Codex Integration (TypeScript)
awesome-mcp-registry - ruvnet/ruflo - agent systems. | (AI & ML (19))
awesome-claude-code-and-skills - ruvnet/ruflo - square) (Multi-Agent Systems / Parallel Processing)
awesome-mcp-lists - GitHub
awesome-ccamel - ruvnet/ruflo - 🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integration, and native Claude Code / Codex Integration (TypeScript)
awesome-claude-code - ruvnet/ruflo - square&logo=github) | Enterprise multi-agent swarm orchestration platform for Claude | (Agent Orchestration)
awesome-ChatGPT-repositories - ruflo - 🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integration, and native Claude Code / Codex Integration (The latest additions 🎉)
awesome-ai-agents - ruvnet/ruflo - Ruflo is a leading agent orchestration platform for Anthropic Claude, enabling the deployment of intelligent multi-agent swarms and coordination of autonomous workflows with enterprise-grade features. (AI Agent Frameworks & SDKs / Multi-Agent Collaboration Systems)
awesome-ai-agents - Ruflo - learning swarms, distributed intelligence, RAG integration, and native Claude Code/Codex integration. Formerly claude-flow. (Frameworks & Libraries / Multi-Agent Orchestration)
awesome-openclaw-skills - Ruflo - agent swarms. If I tried to go into d... | - | (Web & Search)
awesome-ai - ruvnet/ruflo
my-awesome - ruvnet/ruflo - ai,agentic-engineering,agentic-framework,agentic-rag,agentic-workflow,agents,ai-assistant,ai-tools,anthropic-claude,autonomous-agents,claude-code,claude-code-skills,codex,huggingface,mcp-server,model-context-protocol,multi-agent,multi-agent-systems,swarm,swarm-intelligence pushed_at:2026-04 star:34.2k fork:3.9k 🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code / Codex Integration (TypeScript)
awesome-claude-code-toolkit - Ruflo - - deploy multi-agent swarms, coordinate autonomous workflows, distributed swarm intelligence, RAG integration | (Companion Apps & GUIs / Quick Setup with cc-safe-setup)

README

          


[![Ruflo Banner](ruflo/assets/ruflo-small.jpeg)](https://flo.ruv.io/)

[![Try the UI Beta — flo.ruv.io](https://img.shields.io/badge/_Try_the_UI_Beta-flo.ruv.io-6366f1?style=for-the-badge&logoColor=white&logo=svelte)](https://flo.ruv.io/)

[![Goal Planner — goal.ruv.io](https://img.shields.io/badge/_Goal_Planner-goal.ruv.io-8b5cf6?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/)

[![Live Agents — goal.ruv.io/agents](https://img.shields.io/badge/_Live_Agents-goal.ruv.io%2Fagents-10b981?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/agents)

[![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)

[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)

[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-D97757?style=for-the-badge&logoColor=white&logo=anthropic)](https://github.com/ruvnet/claude-flow)

[![Codex Plugin](https://img.shields.io/badge/Codex-Plugin-412991?style=for-the-badge&logoColor=white&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI%2BPHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0yMi4yODIgOS44MjFhNS45ODUgNS45ODUgMCAwIDAtLjUxNi00LjkxIDYuMDQ2IDYuMDQ2IDAgMCAwLTYuNTEtMi45QTYuMDY1IDYuMDY1IDAgMCAwIDQuOTgxIDQuMThhNS45ODUgNS45ODUgMCAwIDAtMy45OTggMi45IDYuMDQ2IDYuMDQ2IDAgMCAwIC43NDMgNy4wOTcgNS45OCA1Ljk4IDAgMCAwIC41MSA0LjkxMSA2LjA1MSA2LjA1MSAwIDAgMCA2LjUxNSAyLjlBNS45ODUgNS45ODUgMCAwIDAgMTMuMjYgMjRhNi4wNTYgNi4wNTYgMCAwIDAgNS43NzItNC4yMDYgNS45OSA1Ljk5IDAgMCAwIDMuOTk4LTIuOSA2LjA1NiA2LjA1NiAwIDAgMC0uNzQ3LTcuMDczek0xMy4yNiAyMi40M2E0LjQ3NiA0LjQ3NiAwIDAgMS0yLjg3Ni0xLjA0bC4xNDItLjA4IDQuNzc4LTIuNzU4YS43OTUuNzk1IDAgMCAwIC4zOTMtLjY4MXYtNi43MzdsMi4wMiAxLjE2OGEuMDcxLjA3MSAwIDAgMSAuMDM4LjA1MnY1LjU4M2E0LjUwNCA0LjUwNCAwIDAgMS00LjQ5NSA0LjQ5NHpNMy42IDE4LjMwNGE0LjQ3IDQuNDcgMCAwIDEtLjUzNS0zLjAxNGwuMTQyLjA4NSA0Ljc4MyAyLjc1OWEuNzcxLjc3MSAwIDAgMCAuNzgxIDBsNS44NDMtMy4zNjl2Mi4zMzJhLjA4LjA4IDAgMCAxLS4wMzMuMDYyTDkuNzQgMTkuOTVhNC41IDQuNSAwIDAgMS02LjE0LTEuNjQ2ek0yLjM0IDcuODk2YTQuNDg1IDQuNDg1IDAgMCAxIDIuMzY2LTEuOTczVjExLjZhLjc2Ni43NjYgMCAwIDAgLjM4OC42NzdsNS44MTUgMy4zNTQtMi4wMiAxLjE2OGEuMDc2LjA3NiAwIDAgMS0uMDcyIDBsLTQuODMtMi43ODZBNC41MDQgNC41MDQgMCAwIDEgMi4zNCA3Ljg3MnptMTYuNTk3IDMuODU1LTUuODMzLTMuMzg3IDIuMDE2LTEuMTY1YS4wNzYuMDc2IDAgMCAxIC4wNzEgMGw0LjgzIDIuNzkxYTQuNDk0IDQuNDk0IDAgMCAxLS42NzYgOC4xMDR2LTUuNjc3YS43OS43OSAwIDAgMC0uNDA3LS42Njd6bTIuMDEtMy4wMjMtLjE0MS0uMDg1LTQuNzc0LTIuNzgyYS43NzYuNzc2IDAgMCAwLS43ODUgMEw5LjQwOSA5LjIzVjYuODk3YS4wNjYuMDY2IDAgMCAxIC4wMjgtLjA2Mmw0LjgzLTIuNzg3YTQuNDk5IDQuNDk5IDAgMCAxIDYuNjggNC42NnpNOC4zMDcgMTIuODYzbC0yLjAyLTEuMTY0YS4wOC4wOCAwIDAgMS0uMDM4LS4wNTdWNi4wNzRhNC40OTkgNC40OTkgMCAwIDEgNy4zNzYtMy40NTRsLS4xNDIuMDgtNC43NzggMi43NThhLjc5NS43OTUgMCAwIDAtLjM5My42ODJ6bTEuMDk3LTIuMzY2IDIuNjAyLTEuNSAyLjYwNyAxLjV2Mi45OTlsLTIuNTk3IDEuNS0yLjYwNy0xLjVaIi8%2BPC9zdmc%2B)](https://www.npmjs.com/package/@claude-flow/codex)

[![🕸️ RuVector Graph Ai](https://img.shields.io/badge/RuVector_Agentic-DB-06b6d4?style=for-the-badge&logoColor=white&logo=graphql)](https://github.com/ruvnet/ruvector)

# Ruflo

**Multi-agent AI orchestration for Claude Code**



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

---

![Ruflo Plugins](./ruflo-plugins.gif)

## 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-autopilot@ruflo

/plugin install ruflo-federation@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.

🔌 All 32 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`](https://npmjs.com/package/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-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 |

#### 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-wasm** | Run sandboxed WebAssembly agents |

| **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`](https://npmjs.com/package/neural-trader) — AI trading with 4 agents, backtesting, 112+ tools |

| **ruflo-market-data** | Ingest market data, vectorize OHLCV, detect patterns |

### CLI Install

```bash

# One-line install

curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

# Or via npx (interactive setup)

npx ruflo@latest init wizard

# Quick non-interactive init

# npx ruflo@latest init

# Or install globally

npm install -g ruflo@latest

```

### MCP Server

```bash

# Add Ruflo as an MCP server in Claude Code (canonical form, matches USERGUIDE.md)

claude mcp add ruflo -- 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 with 150x-12,500x faster search |

| ⚡ **Background Workers** | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |

| 🧩 **Plugin Marketplace** | 32 native Claude Code plugins + 21 npm plugins |

| 🔌 **Multi-Provider** | Claude, GPT, Gemini, Cohere, Ollama with smart routing |

| 🛡️ **Security** | AIDefence, input validation, CVE remediation, path traversal prevention |

| 🌐 **Agent Federation** | Cross-installation agent collaboration with zero-trust security |

| 💬 **[Web UI Beta](https://flo.ruv.io/)** | Multi-model chat at flo.ruv.io with parallel MCP tool calling and an in-browser WASM tool gallery |

| 🎯 **[RuFlo Research](https://goal.ruv.io/)** | GOAP A\* planner at goal.ruv.io — plain-English goals → executable agent plans, with a live agent dashboard at [/agents](https://goal.ruv.io/agents) |



  

    

  



### Web UI (Beta) — self-hostable, hosted demo at [flo.ruv.io](https://flo.ruv.io/)

**RuFlo's web UI is a multi-model AI chat with built-in Model Context Protocol (MCP) tool calling.** Talk to Qwen, Claude, Gemini, or OpenAI while RuFlo invokes the same MCP tools the CLI uses — agent orchestration, persistent memory, swarm coordination, code review, GitHub ops — directly from chat. No install, no API key needed to try it.

| | What it is | Why it matters |

|---|------------|----------------|

| 🧠 | **Any model, local or remote** | 6 curated frontier models out-of-the-box — Qwen 3.6 Max (default), Claude Sonnet 4.6, Claude Haiku 4.5, Gemini 2.5 Pro, Gemini 2.5 Flash, OpenAI — via OpenRouter. Add your own: any OpenAI-compatible endpoint (vLLM, Ollama, LM Studio, Together, Groq, self-hosted). |

| 🦾 | **ruvLLM self-learning AI** | Native support for [ruvLLM](https://github.com/ruvnet/RuVector/tree/main/examples/ruvLLM) (lives in `ruvnet/RuVector/examples/ruvLLM`) — RuFlo's self-improving local model layer. Routes to MicroLoRA adapters, learns from your trajectories via SONA, and stays on your machine. Pair with the cloud models or run fully offline. |

| 🛠️ | **~210 tools, ready to call** | 5 server groups (Core, Intelligence, Agents, Memory, DevTools) plus an 18-tool gallery that runs entirely in your browser — works offline. |

| 🔌 | **Bring your own MCP servers** | Click the **MCP (n)** pill in the chat input → *Add Server* and paste any MCP endpoint (HTTP, SSE, or stdio). Your tools join RuFlo's native ones in the same parallel-execution flow. Run a local MCP server on `localhost:3000` and it just works. |

| ⚡ | **Tools run in parallel** | One model response can fire 4–6+ tools at the same time. The UI shows them as cards with a *Step 1 — 2 tools completed* badge so you can see exactly what ran. |

| 💾 | **Memory that sticks** | Say *"remember my favorite color is indigo"* and ask weeks later — RuFlo recalls it. Backed by AgentDB + HNSW vector search (≥150× faster than brute force). |

| 📘 | **Built-in capabilities tour** | Click the question-mark icon in the sidebar — a "RuFlo Capabilities" modal opens with the full tool list, model strengths, architecture, and keyboard shortcuts. |

| 🏠 | **Self-hostable** | Web UI is shipped as Docker (`ruflo/src/ruvocal/Dockerfile`) with embedded Mongo. Deploy to your own Cloud Run / Fly / Kubernetes / docker-compose. The hosted [flo.ruv.io](https://flo.ruv.io/) demo is one option; running your own is fully supported. |

| 🚀 | **Zero install to try** | Open the hosted URL, pick a model, type a question. That's the whole onboarding. |

**Try the hosted demo:** [https://flo.ruv.io/](https://flo.ruv.io/) — no account, no API key. **Run your own:** the source lives in [`ruflo/src/ruvocal/`](ruflo/src/ruvocal/) with a multi-stage Dockerfile (`INCLUDE_DB=true` builds in MongoDB) and a `cloudbuild.yaml` for Google Cloud Run. See [ADR-033](ruflo/docs/adr/ADR-033-RUVOCAL-WASM-MCP-INTEGRATION.md) for the architecture and [issue #1689](https://github.com/ruvnet/ruflo/issues/1689) for the roadmap.



  

    

  



### Goal Planner UI — autonomous agents at [goal.ruv.io](https://goal.ruv.io/)

**Turn high-level goals into executable agent plans.** `goal.ruv.io` is RuFlo's hosted Goal-Oriented Action Planning (GOAP) front-end — describe an outcome in plain English and watch RuFlo decompose it into preconditions, actions, and an A* path through state space, then dispatch the work to live agents at [`/agents`](https://goal.ruv.io/agents).

| | What it is | Why it matters |

|---|------------|----------------|

| 🎯 | **Plain-English goals** | Type *"ship the auth refactor with tests and a PR"* — RuFlo extracts the success criteria, the constraints, and the implicit preconditions. No JSON, no DSL. |

| 🧭 | **GOAP A\* planner** | Classic gaming-AI planning ported to software work: state-space search through actions with preconditions/effects to find the shortest viable path. Replans on the fly when state changes. |

| 🤖 | **Live agent dashboard** | [goal.ruv.io/agents](https://goal.ruv.io/agents) shows every spawned agent — role, current step, memory namespace, token budget, status. Click in to inspect trajectories, kill runaway workers, or reassign. |

| 🌳 | **Visual plan tree** | Goals render as collapsible action trees with progress, blocked branches, and rollbacks highlighted. See *exactly* why an agent picked a path — no opaque chain-of-thought. |

| ♻️ | **Adaptive replanning** | When an action fails or new info arrives, the planner re-runs A\* from the current state instead of restarting. Failures become learning, not loops. |

| 🧠 | **Shared memory + SONA** | Plans, trajectories, and outcomes flow into AgentDB. Future plans retrieve past solutions via HNSW — the planner gets smarter with every run. |

| 🔗 | **Wired to MCP tools** | Every action node maps to a tool call (RuFlo's ~210 MCP tools, your custom servers, or shell). The planner schedules them in parallel where the dependency graph allows. |

| 🚀 | **Zero install to try** | Open [goal.ruv.io](https://goal.ruv.io/), describe a goal, watch it run. Source lives in [`v3/goal_ui/`](v3/goal_ui/) — Vite + Supabase, self-hostable. |

**Try it:** [https://goal.ruv.io/](https://goal.ruv.io/) for goals · [https://goal.ruv.io/agents](https://goal.ruv.io/agents) for live agents. **Run your own:** clone the `goal` branch and `cd v3/goal_ui && npm install && npm run dev`.

### Agent Federation — Slack for Agents

```

Your Agent --> [ Remove secrets ] --> [ Sign message ] --> [ Encrypted channel ]

                 Emails, SSNs,        Proves it came       No one reads it

                 keys stripped         from you              in transit

                                                                |

                                                                v

Their Agent <-- [ Block attacks ] <-- [ Check identity ] <------+

                 Stops prompt          Rejects forgeries

                 injection

                          Audit trail on both sides.

                  Trust builds over time. Bad behavior = instant downgrade.

```

Slack gave teams channels. Federation gives agents the same thing — **shared workspaces across trust boundaries**, where agents on different machines, orgs, or cloud regions can discover each other, prove who they are, and collaborate on tasks.

The difference: some channels are trusted, some aren't. [`@claude-flow/plugin-agent-federation`](https://github.com/ruvnet/ruflo/issues/1669) handles that automatically. Your agents join a federation, get verified via mTLS + ed25519, and start exchanging work — with PII stripped before anything leaves your node and every message auditable. Untrusted agents can still participate at lower privilege: they see discovery info, not your memory. As they prove reliable, trust upgrades. If they misbehave, they get downgraded instantly — no human in the loop required.

You don't configure handshakes or manage certificates. You `federation init`, `federation join`, and your agents start talking. The protocol handles identity, the PII pipeline handles data safety, and the audit trail handles compliance.

> **📘 Full user guide:** [`docs/federation/`](./docs/federation/) — setup, MCP tools, trust levels, circuit breaker, and the (opt-in) WireGuard mesh layer that ties packet-layer reachability to federation trust. ADR-111 deep-dive at [`docs/federation/phase7-mesh-bringup.md`](./docs/federation/phase7-mesh-bringup.md).

Federation capabilities

| | Capability | How it works |

|---|---|---|

| 🔒 | **Zero-trust federation** | Remote agents start untrusted. Identity proven via mTLS + ed25519 challenge-response. No API keys, no shared secrets. |

| 🛡️ | **PII-gated data flow** | 14-type detection pipeline scans every outbound message. Per-trust-level policies: BLOCK, REDACT, HASH, or PASS. Adaptive calibration reduces false positives. |

| 📊 | **Behavioral trust scoring** | Formula (`0.4×success + 0.2×uptime + 0.2×threat + 0.2×integrity`) continuously evaluates peers. Upgrades require history; downgrades are instant. |

| 📋 | **Compliance built-in** | HIPAA, SOC2, GDPR audit trails as compliance modes. Every federation event produces a structured record searchable via HNSW. |

| 🤝 | **9 MCP tools + 10 CLI commands** | Full lifecycle: `federation_init`, `federation_send`, `federation_trust`, `federation_audit`, and more. |

Example: two teams sharing fraud signals without sharing customer data

```bash

# Team A: initialize federation and generate keypair

npx claude-flow@latest federation init

# Team A: join Team B's federation endpoint

npx claude-flow@latest federation join wss://team-b.example.com:8443

# Team A: send a task — PII is stripped automatically before it leaves

npx claude-flow@latest federation send --to team-b --type task-request \

  --message "Analyze transaction patterns for account anomalies"

# Team A: check peer trust levels and session health

npx claude-flow@latest federation status

```

See [issue #1669](https://github.com/ruvnet/ruflo/issues/1669) for the complete architecture, trust model, and implementation roadmap.

```bash

# Claude Code plugin

/plugin install ruflo-federation@ruflo

# Or via CLI

npx claude-flow@latest plugins install @claude-flow/plugin-agent-federation

```

Claude Code: With vs Without Ruflo

| Capability | Claude Code Alone | + Ruflo |

|------------|-------------------|---------|

| Agent Collaboration | Isolated, no shared context | Swarms with shared memory and consensus |

| Coordination | Manual orchestration | Queen-led hierarchy (Raft, Byzantine, Gossip) |

| Memory | Session-only | HNSW vector memory with sub-ms retrieval |

| Learning | Static behavior | SONA self-learning with pattern matching |

| Task Routing | You decide | Intelligent routing (89% accuracy) |

| Background Workers | None | 12 auto-triggered workers |

| LLM Providers | Anthropic only | 5 providers with failover |

| Security | Standard | CVE-hardened with AIDefence |

Architecture overview

```

User --> Claude Code / CLI

          |

          v

    Orchestration Layer

    (MCP Server, Router, 27 Hooks)

          |

          v

    Swarm Coordination

    (Queen, Topology, Consensus)

          |

          v

    100+ Specialized Agents

    (coder, tester, reviewer, architect, security...)

          |

          v

    Memory & Learning

    (AgentDB, HNSW, SONA, ReasoningBank)

          |

          v

    LLM Providers

    (Claude, GPT, Gemini, Cohere, Ollama)

```

---

## Documentation

Three docs for three audiences:

| Doc | When to read it |

|-----|-----------------|

| **[Status](docs/STATUS.md)** | See what currently works — capability counts, test baselines, recent fixes, what's next. The *is-it-ready* doc. |

| **[User Guide](docs/USERGUIDE.md)** | Daily reference — every command, every config flag, every plugin. The *how-do-I* doc. |

| **[Verification](verification.md)** | Cryptographically prove your installed bytes match the signed witness — `ruflo verify`. The *trust-but-verify* doc. |

User Guide section index:

| Section | Topics |

|---------|--------|

| [Quick Start](docs/USERGUIDE.md#quick-start) | Installation, prerequisites, install profiles |

| [Core Features](docs/USERGUIDE.md#-core-features) | MCP tools, agents, memory, neural learning |

| [Intelligence & Learning](docs/USERGUIDE.md#-intelligence--learning) | Hooks, workers, SONA, model routing |

| [Swarm & Coordination](docs/USERGUIDE.md#-swarm--coordination) | Topologies, consensus, hive mind |

| [Security](docs/USERGUIDE.md#%EF%B8%8F-security) | AIDefence, CVE remediation, validation |

| [Ecosystem](docs/USERGUIDE.md#-ecosystem--integrations) | RuVector, agentic-flow, Flow Nexus |

| [Configuration](docs/USERGUIDE.md#%EF%B8%8F-configuration--reference) | Environment variables, config schema |

| [Plugin Marketplace](https://ruvnet.github.io/ruflo) | Browse and install plugins |

---

## Support

| Resource | Link |

|----------|------|

| Documentation | [User Guide](docs/USERGUIDE.md) |

| Issues & Bugs | [GitHub Issues](https://github.com/ruvnet/claude-flow/issues) |

| Enterprise | [ruv.io](https://ruv.io) |

| Community | [Agentics Foundation Discord](https://discord.com/invite/dfxmpwkG2D) |

| Powered by | [Cognitum.one](https://cognitum.one) |

## License

MIT - [RuvNet](https://github.com/ruvnet)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/ruvnet/ruflo

Awesome Lists containing this project

README