Ruflo

by ruvnet

Community Developer Tools 67k likes

Ruflo runs an MCP server with roughly 200 tools for agent orchestration, persistent memory, and swarm coordination, so Claude Code can manage multiple cooperating agents.

Add to Claude Code

claude mcp add ruflo -- npx ruflo@latest mcp start

Source: https://github.com/ruvnet/ruflo

About

Ruflo is rUv's agent meta-harness: an MCP server, CLI, and set of Claude Code plugins built around coordinating more than one agent at once. Registering it with `claude mcp add ruflo -- npx ruflo@latest mcp start` gives Claude Code access to tool groups for orchestration (swarm_init, agent_spawn), persistent memory (memory_store, memory_search), and agent federation (federation_init, federation_send), letting agents on different machines or cloud regions trust and message each other over mTLS.

The memory layer uses vector search with HNSW indexing rather than a flat lookup, and background workers run continuously to keep learned patterns current instead of retraining on demand. It's aimed at teams that have outgrown a single agent working one task at a time and want a shared, queryable memory plus a coordination layer instead of gluing several agent sessions together by hand.

Key features

  • MCP server exposing roughly 200 tools across orchestration, memory, agent, and DevOps groups
  • swarm_init / agent_spawn for coordinating multiple agents on a shared task
  • Vector memory with HNSW indexing for faster similarity search than a linear scan
  • Agent federation (federation_init/send/trust) for cross-machine or cross-org agent collaboration over mTLS
  • Installable as lightweight Claude Code plugins (ruflo-core, ruflo-swarm) or as a full CLI

Use cases

  • Coordinating a swarm of specialized sub-agents (coding, testing, security review) on one larger task
  • Giving a long-running agent persistent, searchable memory across sessions instead of starting from zero
  • Connecting agents running in different environments or organizations through the federation tools
  • Adding orchestration and memory to Claude Code without building a custom multi-agent harness from scratch

Available tools

swarm_init

Initializes a coordinated group of agents for a shared task.

agent_spawn

Creates a new agent instance within an active swarm.

memory_store

Writes a piece of information into Ruflo's persistent vector memory.

memory_search

Runs a similarity search over stored memory using HNSW indexing.

federation_init

Sets up a trust relationship for agents on separate machines or environments to collaborate.

Frequently asked questions

Do I need the full CLI installed to use the MCP server?

No. `claude mcp add ruflo -- npx ruflo@latest mcp start` runs it on demand through npx. The full CLI (`npm install -g ruflo@latest`) is only needed for the interactive init wizard or standalone commands.

What's the difference between the memory and federation tool groups?

Memory tools (memory_store/memory_search) persist and retrieve information for a single agent or swarm. Federation tools (federation_init/send/trust) let separate Ruflo deployments, potentially on different machines or orgs, establish trust and pass messages to each other.