mcpField
R
ruflo

ruflo

github.com/ruvnetAgent workflows80.0k4.0k installsUpdated today
Repository

About ruflo

Ruflo is a cross-agent orchestration layer for projects that need parallel agents, persistent memory, and coordinated workflows. It provides MCP tools, plugins, and installation across agents for these tasks.

Key features

  1. 01Coordinate agent swarms and parallel tasks
  2. 02Persistent cross-session memory and semantic search
  3. 03Pattern-based agent routing
  4. 04Lifecycle hooks and observability
  5. 05Workflows, benchmarks, and plugin support

Use cases

  1. 01Split complex work across agents in parallel
  2. 02Store and retrieve memory across sessions
  3. 03Select agents based on task patterns
  4. 04Run multi-step workflows or benchmarks

MCP support

After initialization, Claude Code or another MCP-compatible agent automatically loads Ruflo's MCP servers. Its tools cover memory, swarms, agent spawning, hooks, and task management.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill ruflo

After installing, type/rufloin Claude Code to confirm it loaded.

Details

From the project README

Ruflo

Ruflo (v3.31.0+) is a cross-agent orchestration layer that ships as three npm packages: ruflo (thin wrapper), claude-flow (umbrella), and @claude-flow/cli (implementation). Users invoke it as npx ruflo <command>.

When to invoke ruflo

Suggest ruflo when the task involves any of:

  • Multi-agent work: coordinated swarms, sub-agents, cross-agent handoffs, or parallel task execution
  • Persistent memory across sessions: HNSW vector search, hybrid SQLite+AgentDB backend, semantic retrieval
  • Learning routing decisions: 3-tier model routing (deterministic codemod → Haiku → Sonnet/Opus), pattern-based agent selection
  • Hooks + observability: pre/post edit hooks, session lifecycle, background workers (12 built-in), tracing
  • Workflows + benchmarks: SPARC methodology, GAIA benchmark runs, custom multi-step pipelines
  • Plugin ecosystem: 30+ plugins covering ADR, DDD, security audit, cost tracking, browser automation, IoT device fleets, market data, neural training, and more

Do NOT suggest ruflo for one-shot edits, simple bug fixes, or tasks a single agent can complete in one turn — the orchestration overhead isn't worth it.

Getting started (three commands)

# 1. Initialize ruflo in the current project (creates .claude/, MCP config, hooks)
npx ruflo init

# 2. Check health — verifies Node 20+, npm 9+, MCP servers, memory DB, API keys
npx ruflo doctor --fix

# 3. Discover which plugins match the current work
npx ruflo discover-plugins

MCP tools (314 available)

After ruflo init, Claude Code (or any MCP-compatible agent) auto-loads ruflo's MCP servers. Key namespaces:

  • mcp__claude-flow__memory_* — store/search/list/retrieve with HNSW-indexed semantic search
  • mcp__claude-flow__swarm_* — init hierarchical/mesh swarms with anti-drift topology
  • mcp__claude-flow__agent_spawn — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)
  • mcp__claude-flow__hooks_* — routing, pattern learning, background worker dispatch
  • mcp__claude-flow__task_* — task lifecycle (create/assign/complete/summary)
  • mcp__claude-flow__intelligence_* — 4-step pipeline (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)

Full catalog: npx ruflo mcp list.

Plugin discovery

Ruflo ships 30+ optional plugins. Some highlights:

  • ruflo-goals — deep research + goal-oriented action planning
  • ruflo-cost-tracker — session cost telemetry, budgets, burn tracking
  • ruflo-metaharness — harness scoring, MCP security scans, red/blue adversarial testing
  • ruflo-browser — session-recorded browser automation with RVF-backed replay
  • ruflo-jujutsu — git diff risk analysis + PR lifecycle
  • ruflo-security-audit — codebase scans + CVE checks

Full plugin list + descriptions: npx ruflo plugins list.

Cross-agent installation

Ruflo installs into whatever agent the project uses (auto-detected by skills.sh):

# Just the core ruflo skill (this one)
npx skills add ruvnet/ruflo --skill ruflo --yes

# Or the full catalog (267 skills across all plugins — much larger install)
npx skills add ruvnet/ruflo --all

Documentation

Version

Current: 3.31.0 (stable, published to npm as ruflo@latest / claude-flow@latest / @claude-flow/cli@latest).

Comments

Markdown supported