BACK TO MCP SERVERS
dev-toolsany

Ruflo

Agent teams, swarms, memory and hooks for Claude Code and Codex, served over MCP.

At a glance

Not tested yet
GitHub stars
82,150
Weekly downloads
56,415
Last commit
2026-11-20
Licence
MIT
Transport
stdio
Auth
none
Install
npx -y ruflo
Stats checked 2026-11-20

What it does

Ruflo is an agent meta-harness for Claude Code and Codex. It adds agents, hooks, memory and an MCP server to a project so coding agents can run coordinated tasks. It is for developers who want to set up and monitor agent work inside their own project folder.

Ruflo animated neon sign
Image: ruvnet/ruflo (MIT)

Key features

  • init adds ruflo's agents, hooks, memory and MCP server to a project, and Claude Code picks them up on its next start.
  • Codex and other MCP clients can connect to the MCP server.
  • Mission Control console opens with /ruflo in Claude Code to monitor workflows, agents, models, token use and cost.
  • You can inspect a run: search logs and results, triage failures, replay a run and compare outcomes.
  • Claude control settings let you pick a permission level (read, write, manage, full) and approval mode (ask or auto).
  • A terminal UI runs on its own without Claude Code.

Quick start

Run this in your project folder:

npx ruflo@latest init

Then open Claude Code in the same folder and give it a task. To set up a project interactively, run:

npx ruflo@latest init wizard

To add Ruflo as an MCP server in Claude Code:

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

Add it to Claude Code from a terminal:

claude mcp add ruflo -- npx -y ruflo

Or add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "ruflo": {
      "command": "npx",
      "args": [
        "-y",
        "ruflo"
      ]
    }
  }
}

Environment variables

The registry entry declares no environment variables.

Example prompts

  • Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.
  • Create a mission to add a dark mode toggle. Show me the mission and its status.
  • Name the module you chose, show the test you added, and report the test command and result.

What to watch out for

  • The README describes two install paths with very different surface areas: the Claude Code plugin route and the CLI install (npx ruflo init).
  • The Claude Code plugin route needs Claude Code 2.1.287 or later.
  • Mods run with your account's permissions, so review their code before installing.
  • Network, spending and destructive actions require confirmation even in auto approval mode.
  • The curl ... | bash install form needs a POSIX shell such as Git-Bash, WSL or MSYS.

Not tested by tools4agents yet. Read the source repository before you install it.

GitHub SourceGitHub Stars
Last verified 2026-11-20

Similar tools