What it does
Ruflo is an AI agent orchestration CLI that brings multi-agent coordination to Claude Code. It bundles 100+ specialized agents that self-organize into swarms, learn from task outcomes, and persist memory across sessions. The hooks system automatically routes new tasks based on learned patterns, while federated communication allows agents to collaborate across machines without exposing raw data. An embedded MCP server registers agent definitions and memory stores to Claude's runtime.
Who it's for
Teams scaling Claude to multiple specialized agents on complex projects, organizations that need cross-team collaboration without leaking sensitive data between agents, and engineers building agentic workflows that improve over time through feedback loops.
Common use cases
- Swarm multiple agents on a task (design, implementation, testing) with automatic role routing
- Learn agent strengths across prior tasks and reuse successful patterns
- Federate agents across teams or security boundaries
- Persist agent memory and performance metrics across sessions
- Route tasks to agents based on historical success on similar work
Setup pitfalls
- 30 secrets were detected in the package; audit the source and dependencies before production use
- Requires write access to workspace directories (
.claude/,CLAUDE.md,.claude-flow/) and cannot run in read-only or sandboxed environments - High risk: the hooks system executes code on every Claude Code operation; review hook definitions and understand the execution model before deploying
- MCP server registration modifies Claude Code's environment configuration; ensure the daemon remains running or manually clean up the server registration after uninstall