ruvnet /ruflo
🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
★ 81,802⑂ 9,647👁 476⑃ 2,640● 2,212▤ 1,746
+108
Daily
+489
Weekly
+7,378
Monthly
81,802
stars
9,647
forks
476
watchers
2,640
prs
2,212
issues
1,746
releases
README
An agent meta-harness for Claude Code and Codex. Get started in one command Run this in your project folder: bash npx ruflo@latest init Then open Claude Code in the same folder and give it a real task, for example: text Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed. init adds ruflo's agents, hooks, memory and MCP server to the project, and Claude Code picks them up on its next start. Codex and other MCP clients work too: point them at npx -y ruflo@latest mcp start. First useful task, step by step · User guide · Compare install paths Other ways to install (Claude Code plugins only, MCP-only clients, terminal UI) Claude Code plugins only. This route installs core tools, the visual console and runtime mods, with no files added to your project. It needs Claude Code 2.1.287 or later. Run inside Claude Code: text /plugin marketplace add ruvnet/ruflo /plugin install ruflo-core@ruflo /plugin install ruflo-console@ruflo /plugin install ruflo-mods@ruflo /reload-plugins /ruflo From a terminal, on Claude Code 2.1.292 or later: claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo. Mods run with your account's permissions, so review their code before installing. Codex or another MCP client, without project setup. Configure the command npx with the arguments ["-y", "ruflo@latest", "mcp", "start"]. To set up a project interactively, run npx ruflo@latest init wizard. Plain terminal. The console also runs on its own, without Claude Code: npx ruflo tui. Add --plain to print one frame for scripts. See the terminal UI guide. Optional: ruOS Desktop Connect ruOS to ChatGPT or Claude via MCP: text https://ruos.cognitum.one/mcp bash npx ruvector Ruflo English · 简体中文 📖 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. Conceptual learning loop. Local vector retrieval and contrastive updates can run without an LLM; embeddings and configured learning modules are still required. See the RuVector training integration and trajectory contrastive learning. Architecture in text User → Ruflo (CLI/MCP) → Rout
Top issues
#3189[verification] HIGH: Witness signature verification fails — all platform manifests report every entry missing103 comments · 2026-09-05#2156[Dream Cycle 2026-05-27] intelligence: SR²AM 8B=120–355B via simulative planning — 95% token gap + capabilities,memory scan55 comments · 2026-05-27#2036track: ADR-121 — embeddings upgrade to ruvector 0.2.x + @ruvector family33 comments · 2026-05-17#3154[verification] HIGH: @claude-flow/cli@alpha --version times out (>60s, SIGTERM) in cold-cache npx22 comments · 2026-09-01#958Still can't figure out how to get v3 to actually perform work.19 comments · 2026-01-17#310Feasibility study of making claude-flow a universal orchestration layer that works for any CLI coding tool19 comments · 2025-07-15#4683[verification] HIGH: witness drift=6 on all platform manifests (source-only checkout, dist not built)17 comments · 2026-11-04#578Implement workflow and automation commands with --claude and --non-interactive modes17 comments · 2025-08-04
Discussions
#4903I don't feel any effects.1 comments · 2026-11-09#4670401 eror2 comments · 2026-11-03#4630issue of integration between Ruflo and Ollama1 comments · 2026-11-01#4620Show and tell: independent review probes with a JSON-derived gate0 comments · 2026-10-31#4575Ruflo swarms: a receipt check that fails loudly0 comments · 2026-10-29#4348Show & tell: a false-consensus check for swarm outputs (remote MCP, one command)0 comments · 2026-10-21#4309Is that ture?2 comments · 2026-10-20#4294How to use ruflo with the claude application (Not Claude Code CLI/Terminal)2 comments · 2026-10-19
Latest release
v3.77.1 — AgentDB honours the configured embedding model v3.77.1 2026-11-133.77.1 Fix: AgentDB now honours the configured embedding model and dimension (4984, 4985) memory_store ignored .claude-flow/embeddings.json after 2305: the controller registry created AgentDB with only a dbPath, so a configured model and dimension were dropped and AgentDB fell back to all-MiniLM-L6-v2 at 384 dimensions. - @claude-flow/memory 3.3.3 forwards the configured dimension to AgentDB and installs the configured embedder, rejecting vectors of the wrong length. - The CLI memory bridge passes a local embedder when a non-default model is configured, and labels stored rows by the embedde
相关报道 (6)
bilibili这周 GitHub 最火的 10 个开源项目(10.17–10.24):几乎被 AI 编程 agent 包场了2026-10-24OrcaRouterRufRoot:未经身份验证的 Ruflo MCP 桥接 RCE,CVSS 10.02026-10-30QQ News本周 GitHub 涨得最猛的十个 AI 开源项目, GitHub 被 AI agent 占领了2026-10-25Pasquale PillitteriClaude Flow (Ruflo):面向 Claude Code 的多智能体编排完整指南2026-05-02Pasquale PillitteriClaude Code Routines: 新云端自动化完整指南 (Schedule, API, GitHub)2026-04-30腾讯新闻狂揽 21.6k Star!Claude Code多智能体编排神器Ruflo开源,Token成本直降75%2026-03-19
News & coverage (12)
Hacker NewsRuflo: An agent meta-harness for Claude Code and Codex▲ 3 · 0 comments · 2026-07-25Hacker NewsIs any one using ruflo?▲ 1 · 1 comments · 2026-04-29The Globe and MailCognitum One Unveils MetaHarness, the Open-Source Factory for Branded, Governed AI Agent Harnesses, in Conjunction with GitHub Universe 20262026-10-28Yahoo FinanceCognitum One Releases Ruflo, AI Agent Orchestration for Claude Code and Codex, with Mission-Driven Mods and a Single Agent Control Plane2026-10-13SecurityWeekCritical Ruflo Flaw Lets Attackers Spawn Rogue AI Swarms2026-07-30InfoWorldCritical Ruflo flaw lets attackers hijack AI agents through exposed MCP bridge2026-07-30Yahoo FinanceNoma Labs Discovers Critical Vulnerability in Widely Adopted Open Source AI Agent Platform Ruflo2026-07-29ACCESS NewswireCognitum One Launches Ruflo for Claude Code and Codex2026-10-13Augment CodeRuflo v3.32.22: the meta-harness adding swarms, memory, and federation to Claude Code2026-07-27Augment CodeRuflo ships multi-agent orchestration for Claude Code: why teams are wrapping the wrapper2026-05-20