ruvnet/ruflo

Quick Start

There are two different install paths with very different surface areas. Pick based on what you need (#1744):

• What it gives you — Slash commands + a few skills + agent definitions per-plugin — Full Ruflo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon
• Files in your workspace — Zero — .claude/, .claude-flow/, CLAUDE.md, helpers, settings
• MCP server registered — Only if ruflo-core is installed (it ships its own .mcp.json) — most other plugins don't — Yes
• Hooks installed — No — Yes
• Best for — Try a single plugin's commands without committing to the full install — Production use — everything works as documented

CLI Install

# One-line install (POSIX shells only — see Windows note below)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

One task: create a mission with Claude

Watch the recorded console session below. Claude creates a mission, opens the Learning and Security pages, and reports its actions in Overview.

What the recording demonstrates: a real Claude Haiku session with write + auto, mission creation, page navigation, a refused swarm stop, and control being taken back. The steps above use ask so you approve creation yourself. The linked workflow animation uses sample data, while the theme demo replays renderer frames. Neither is evidence of completed swarm work or memory recall.

Implementation and recorded test findings · Reproduction script

Install the mods from the ruflo marketplace (Claude Code 2.1.287 or later; mods run with your account's permissions and are not sandboxed, so read the code first):

• Set the boundary. Install the console using the commands below, open /ruflo, then choose Settings → Claude control → write + ask.
• Give a concrete request. Try: “Create a mission to add a dark mode toggle. Show me the mission and its status.”
• Approve creation. Claude opens Missions and sets the goal. Confirm the pending create action in the console.
• Verify the result. Check that Missions contains the goal and Overview records the action. Creating a mission does not mean the feature has been implemented.
• Keep control. Take back control pauses Claude's console tools. A later call should be refused until you restore control.

Path A — Claude Code Plugins (lite, slash commands only)

This adds slash commands and agent definitions. ruflo-core (installed above) does register its own MCP server on install — its tools are callable as mcppluginruflo-coreruflo (e.g. mcppluginruflo-coreruflomemorystore), not the bare memorystore/swarminit/agentspawn names the CLI-track scaffold uses. Other plugins generally don't ship their own MCP server. For the full loop with the CLI-track tool names, use Path B below.

• ruflo-core — Foundation — server, health checks, plugin discovery
• ruflo-swarm — Coordinate multiple agents as a team
• ruflo-autopilot — Let agents run autonomously in a loop
• ruflo-loop-workers — Schedule background tasks on a timer
• ruflo-workflows — Reusable multi-step task templates
• ruflo-federation — Agents on different machines collaborate securely
• ruflo-agentdb — Fast vector database for agent memory
• ruflo-rag-memory — Smart retrieval — hybrid search, graph hops, diversity ranking
• ruflo-rvf — Save and restore agent memory across sessions
• ruflo-ruvector — ruvector — GPU-accelerated search, Graph RAG, 103 tools
• ruflo-knowledge-graph — Build and traverse entity relationship maps
• ruflo-intelligence — Agents learn from past successes and get smarter
• ruflo-graph-intelligence — Sublinear graph reasoning — PageRank, delta updates, complexity-aware execution (ADR-123)
• ruflo-daa — Dynamic agent behavior and cognitive patterns

What You Get

• 100+ Agents — Specialized agents for coding, testing, security, docs, architecture
• Comms Layer — Zero-trust federation — agents across machines/orgs discover, authenticate, and exchange work securely
• Swarm Coordination — Hierarchical, mesh, and adaptive topologies with consensus
• Self-Learning — SONA neural patterns, ReasoningBank, trajectory learning
• Vector Memory — HNSW-indexed AgentDB — measured ~1.9x faster at N=20k, ~3.2x–4.7x at N=5k vs brute force (recall@10 ~0.99); ANN wins above the crossover, ties/loses at small N. See audit + scripts/ben
• Background Workers — 12 auto-triggered workers (audit, optimize, testgaps, etc.)
• Plugin Marketplace — 33 native Claude Code plugins + 21 npm plugins
• Multi-Provider — Claude, GPT, Gemini, Cohere, Ollama with smart routing
• Security — AIDefence, input validation, CVE remediation, path traversal prevention
• Agent Federation — Cross-installation agent collaboration with zero-trust security
• MetaHarness — Audit your AI agent setup before you ship. Grade readiness (1-100), scan tool configs for security issues, snapshot the whole project to catch regressions over time, and find templates t