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
npx -y ruflo
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.

Key features
initadds 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
/rufloin 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 (askorauto). - 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
autoapproval mode. - The
curl ... | bashinstall 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.
Similar tools
Everything
The official test server. Exercises every part of the protocol, so it is the fastest way to check your setup works at all.
Filesystem
Gives an agent scoped read and write access to directories you name explicitly. The usual first MCP server people install.
Git
Read, search, and manipulate local Git repositories. Lets an agent inspect history and diffs without shelling out.
Sequential Thinking
Gives a model a scratchpad for multi step reasoning, letting it revise earlier steps instead of committing to a first answer.