Repolode
Submit
ruvnet

ruvnet/ruflo

An agent harness for Claude Code and Codex that adds multi-agent swarms, self-learning memory, vector retrieval and cross-machine agent federation.

View on GitHubWebsite
Stars
76,810
Forks
9,071
Open issues
1,064
Last commit
9 hours ago

What is it?

Ruflo is an execution layer around Claude Code and Codex. It coordinates multiple specialized agents as swarms, routes tasks between them, and keeps memory across sessions so that later work can draw on earlier results. It is installed through a Claude Code plugin marketplace or through an npx setup command, and it can also expose its tools to other MCP-enabled clients.

The project bundles several subsystems: a vector memory (AgentDB, HNSW-indexed), trajectory-based learning, background workers, cost tracking, a terminal UI and a browser-style console for inspecting agent runs. A federation layer lets agents on different machines authenticate with mTLS and ed25519, and it filters outbound data for PII before messages leave a node.

Ruflo is a TypeScript project under the MIT license. Its plugins cover areas such as security auditing, DDD scaffolding, SPARC methodology, testing and documentation generation, so teams can adopt only the parts they need.

Key features

  • 01Coordinates 100+ specialized agents as hierarchical, mesh or adaptive swarms.
  • 02Stores agent memory in an HNSW-indexed vector database for retrieval across sessions.
  • 03Learns from task trajectories and feedback to inform later routing.
  • 04Lets agents on different machines authenticate and exchange work through federation with PII filtering.
  • 05Provides a terminal UI and console for watching agent runs, costs and logs.
  • 06Works with Claude Code via plugins and with other MCP clients via an MCP server.

Use cases

  • Running parallel coding, testing and review agents on a codebase inside Claude Code.
  • Keeping project context and past decisions available to agents across multiple sessions.
  • Letting agents on separate machines or organizations collaborate without sharing raw data.
  • Tracking token usage and cost across agent workflows.

Quick start

  1. 1

    Install the core plugin in Claude Code via the marketplace

    /plugin marketplace add ruvnet/ruflo
  2. 2

    Run the setup wizard in your project terminal

    npx ruflo@latest init wizard
  3. 3

    Start the Ruflo MCP server for clients that support stdio MCP

    npx -y ruflo@latest mcp start

Things to know

  • Requires Claude Code 2.1.287 or later for the plugin install path.
  • Mods run with your account's permissions and are not sandboxed, so review their code before installing.
  • Console and mod features are Claude Code integrations; hook support depends on the client.

Topics

#agentic-ai#multi-agent#claude-code#mcp-server#vector-memory#swarm#typescript#agentic-framework#agentic-workflow#agents

FAQ

What is ruflo?
An agent harness for Claude Code and Codex that adds multi-agent swarms, self-learning memory, vector retrieval and cross-machine agent federation. Ruflo is an execution layer around Claude Code and Codex. It coordinates multiple specialized agents as swarms, routes tasks between them, and keeps memory across sessions so that later work can draw on earlier results. It is installed through a Claude Code plugin marketplace or through an npx setup command, and it can also expose its tools to other MCP-enabled clients.
Is ruflo free to use? What license does it have?
ruflo is open source under the MIT license. Check the license terms before using it in commercial products.
Is ruflo still maintained?
Actively maintained. The last commit to ruflo was on Oct 19, 2026.
What can I use ruflo for?
Running parallel coding, testing and review agents on a codebase inside Claude Code. Keeping project context and past decisions available to agents across multiple sessions. Letting agents on separate machines or organizations collaborate without sharing raw data. Tracking token usage and cost across agent workflows.
How do I install ruflo?
Install the core plugin in Claude Code via the marketplace: /plugin marketplace add ruvnet/ruflo Run the setup wizard in your project terminal: npx ruflo@latest init wizard Start the Ruflo MCP server for clients that support stdio MCP: npx -y ruflo@latest mcp start
Where can I get ruflo?
The source code and installation instructions are on GitHub: https://github.com/ruvnet/ruflo

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects