🌊 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
TypeScriptMITCreated 2025-06-02cognitum.one
More from this author
Download: v3.77.1 — AgentDB honours the configured embedding modelv3.77.1 ↓3.77.12026-11-13
+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

Discussions

Latest release

v3.77.1 — AgentDB honours the configured embedding model v3.77.1 2026-11-13
3.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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON