ruflo (ruvnet/ruflo)

agent-memory
Searching Database…

77.2K ·GitHub
What is this?Ruflo is an agent meta-harness for Claude Code and Codex: it adds 100+ specialized agents, coordinated swarms, self-learning memory, and cross-machine federation on top of those coding agents so they can collaborate instead of running solo.
Is this a Claude Code plugin or a standalone CLI tool?Both are offered: installing individual Claude Code plugins only adds slash commands and agent definitions with no files added to your workspace, while the full CLI install (npx ruflo init) sets up the complete loop - 98 agents, 60+ commands, 30 skills, an MCP server, hooks and a daemon.
How do I get it running?Run npx ruflo init (or the equivalent npx ruflo@latest init wizard) to scaffold the full CLI install with its MCP server and hooks, or install individual Claude Code plugins from the marketplace for a lighter, commands-only setup.
Do I need Claude Code or Codex already set up?Yes, Ruflo is a harness built around those coding agents rather than a standalone model; it also requires Node.js 20 or newer to run.
Does the one-line curl install work on native Windows?Not directly - the curl ... | bash installer needs a POSIX shell (Git-Bash, WSL, or MSYS); on plain PowerShell or cmd you should use the npx ruflo@latest init wizard instead, which runs the same init flow.
What is the Web UI beta and do I need an API key for it?It's a self-hostable, multi-model chat (Qwen, Claude, Gemini, OpenAI via OpenRouter) that calls the same roughly 210 MCP tools as the CLI; the hosted demo at flo.ruv.io needs no install and no API key to try.
How does agent memory and federation work?Memory is backed by an HNSW-indexed vector store (AgentDB) so agents recall facts across sessions, and federation lets agents on different machines or orgs discover and exchange work securely under zero-trust authentication without leaking data.
What plugins ship with Ruflo?35 official plugins cover orchestration (swarm, autopilot, federation), memory (agentdb, rag-memory, knowledge-graph), testing (testgen, browser), security (security-audit, aidefence) and DevOps (observability, cost-tracker), shipped as 33 native Claude Code plugins plus 21 npm plugins.
Where does the name Ruflo come from?It's the successor to Claude Flow, renamed by its creator rUv - 'Ru' from rUv and 'flo' from working in flow states until 3am.
Creator
ruvnet
Size
641.5 MB
Stars
77.2K
Age
1y
Commits · 90 Days