claude-flow (ruflo)

★ 64.160

Orchestration multi-agents pour Claude Code, Codex & co : essaims, mémoire adaptative, intégration RAG.

claude-flow (dépôt renommé en ruflo ; les paquets npm claude-flow et ruflo coexistent, actuellement tous deux en version 3.25.6) est un framework d'orchestration multi-agents pour Claude Code, Codex et d'autres agents de codage. Sa pièce maîtresse est une coordination d'essaim « Queen-led » : plusieurs agents travaillent sur des sous-tâches, se synchronisent via des mécanismes de consensus (Raft, Byzantine, Gossip) et partagent une mémoire commune.

Cette mémoire (AgentDB) est indexée en HNSW pour la recherche vectorielle et, selon la documentation du projet, plusieurs fois plus rapide qu'une recherche par force brute naïve sur des volumes de données modestes ; s'y ajoutent recherche hybride et parcours de graphe. Via les SONA Neural Patterns et une « ReasoningBank », les agents sont censés apprendre des déroulements de tâches passées et réutiliser les stratégies gagnantes sur des tâches futures similaires.

Le framework est agnostique du modèle (Claude, GPT, Gemini, Cohere, en local via Ollama) avec routage automatique, embarque environ 210 outils MCP répartis sur cinq groupes de serveurs (Core, Intelligence, Agents, Memory, DevTools) et peut aussi s'installer comme un ensemble de plugins Claude Code (entre autres ruflo-core, ruflo-swarm, ruflo-rag-memory). Une fonction de fédération permet de relier plusieurs instances de claude-flow au-delà des frontières d'équipe ou d'organisation via WebSocket, et de se transmettre des tâches entre elles.

🔧 SETUP

Configuration interactive : `npx ruflo@latest init wizard` (sans assistant : `npx ruflo@latest init`)
Sinon, installation globale : `npm install -g ruflo@latest`
Enregistrer comme serveur MCP dans Claude Code : `claude mcp add ruflo -- npx ruflo@latest mcp start`
En option comme plugins Claude Code : `/plugin install ruflo-core@ruflo`, `/plugin install ruflo-swarm@ruflo`, `/plugin install ruflo-rag-memory@ruflo`
Pour une mise en réseau inter-équipes : `npx claude-flow@latest federation init` ou `federation join wss://...`

✅ QUAND L’UTILISER ?

Coordonner plusieurs agents en parallèle

Une fonctionnalité complexe est découpée en sous-tâches, plusieurs agents y travaillent simultanément selon une topologie d'essaim, avec une mémoire partagée.

Les agents doivent apprendre de l'expérience

SONA/ReasoningBank mémorise les trajectoires de tâches réussies et les réapplique sur des tâches futures similaires.

⛔ QUAND ÉVITER ?

Tâche unique et simple

Le coût de mise en place de l'essaim, de la mémoire et des mécanismes de consensus n'en vaut pas la peine pour une tâche unique et bien délimitée, qu'un seul agent peut résoudre seul.

Mieux: Utiliser Claude Code directement, sans couche d'orchestration.

Fédération inter-équipes sans infrastructure

La fédération nécessite un point de terminaison WebSocket accessible (wss://) — impossible à exploiter utilement sans infrastructure serveur propre.

Mieux: Configuration locale sans commandes de fédération, une seule instance.