# Ruflo — Swarm Orchestration CLI + MCP

> Ruflo is a CLI + MCP stack for orchestrating agent swarms in Claude Code, with one-line install and an MCP server mode you can add via `claude mcp add`.

## Install

Copy the content below into your project:

## Quick Use

1. Install / set up:
   ```bash
   curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
   ```
2. Start / smoke test:
   ```bash
   npx ruflo@latest init wizard
   ```
3. Verify:
   - Add it as an MCP server (`claude mcp add ruflo -- npx ruflo@latest mcp start`) and confirm the server shows as connected in `/mcp`.

## Intro

Ruflo is a CLI + MCP stack for orchestrating agent swarms in Claude Code, with one-line install and an MCP server mode you can add via `claude mcp add`.

- **Best for:** Teams coordinating many agent tasks who want a repeatable swarm + plugin workflow
- **Works with:** Node.js tooling (npx/npm) + Claude Code MCP
- **Setup time:** 10 minutes

## Practical Notes

- Setup time ~10 minutes (install + init wizard)
- Measurable check: MCP server connects (visible in `/mcp`) and at least 1 orchestration command runs without errors
- GitHub stars + forks (verified): see Source & Thanks

Swarm orchestration only pays off if you make it observable and safe:

- Keep a small set of standardized plugins (test generation, security audit, docs).
- Gate risky actions behind explicit approval steps.
- Prefer deterministic inputs (spec files, issue templates) so multiple agents converge.

Start with one workflow (e.g., plan → implement → review) and only then expand into federation/multi-machine setups.

### FAQ

**Q: Is there a one-line install?**
A: Yes — the README shows a curl-based install script.

**Q: Can I run it via npx?**
A: Yes — the README includes `npx ruflo@latest init wizard` and MCP start commands.

**Q: How do I attach it to Claude Code?**
A: Use `claude mcp add ruflo -- npx ruflo@latest mcp start`.

## Source & Thanks

> Source: https://github.com/ruvnet/ruflo
> License: MIT
> GitHub stars: 49,094 · forks: 5,448

---

<!-- ZH -->

## 快速使用

1. 安装 / 设置：
   ```bash
   curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
   ```
2. 启动 / 冒烟测试：
   ```bash
   npx ruflo@latest init wizard
   ```
3. 验证：
   - 用 `claude mcp add ruflo -- npx ruflo@latest mcp start` 添加为 MCP；在 `/mcp` 中确认已连接。

## 简介

Ruflo 提供 CLI + MCP 的群体编排栈：支持一键安装与初始化，并可通过 `claude mcp add` 作为 MCP server 接入 Claude Code，便于组织 swarm 工作流。

- **适合谁：** 需要协调大量 agent 任务的团队，希望把 swarm 与插件化流程做成可复用模板
- **可搭配：** 基于 Node.js 的工具链（npx/npm）+ Claude Code MCP
- **准备时间：** 10 分钟

## 实战建议

- 准备时间约 10 分钟（安装 + init 向导）
- 可量化检查：MCP server 在 `/mcp` 可见且已连接，并至少跑通 1 个编排命令无报错
- GitHub stars / forks（已核验）：见「来源与感谢」

群体编排要“值回票价”，关键在于可观测与可控：

- 先固定一小套标准插件（补测试、安全审计、文档）。
- 高风险操作必须显式审批。
- 尽量让输入更确定（规范文件、issue 模板），多 agent 才容易收敛。

建议先从单机单流程（plan → implement → review）跑通，再考虑 federation/多机器。

### FAQ

**支持一键安装吗？**
答：支持，README 提供了 curl 一行安装脚本。

**能用 npx 跑吗？**
答：可以，README 给了 `npx ruflo@latest init wizard` 与 MCP 启动方式。

**怎么接入 Claude Code？**
答：用 `claude mcp add ruflo -- npx ruflo@latest mcp start`。

## 来源与感谢

> Source: https://github.com/ruvnet/ruflo
> License: MIT
> GitHub stars: 49,094 · forks: 5,448


---
Source: https://tokrepo.com/en/workflows/ruflo-swarm-orchestration-cli-mcp
Author: Agent Toolkit