Ruflo essaims agents IA : le dépôt ruvnet/ruflo se présente comme un « méta-harnais d’agents » pour Claude Code et Codex, qui ajoute des agents spécialisés, des essaims coordonnés, une mémoire et une console de suivi. Il affichait environ 78 300 étoiles et 9 200 forks en octobre 2026, relevés sur la page du dépôt le 22 octobre, avec plus de 9 800 commits et une licence MIT. Le README raconte que le projet s’est d’abord appelé Claude Flow.
Pour un SRE, deux choses comptent : ce que Ruflo ajoute à un agent de code (coordination de plusieurs agents, mémoire, routage) et ce qu’il permet de voir (activité, tokens, coût). Le dépôt est aussi un bon exemple de projet dont le README affiche beaucoup de chiffres, qu’il faut lire comme des déclarations.
Les informations viennent du README du dépôt, lu le 22 octobre 2026. span.observer n’a pas installé Ruflo : l’image et les commandes ci-dessous viennent du dépôt.
Ruflo essaims agents IA : ce que dit le dépôt
- Qui : le compte
ruvnet; le README attribue le projet à Reuven Cohen (rUv) et dit qu’il tourne sur l’architecture Cognitum.One. Le premier commit date, selon le README, du 2 juin 2025. - Licence : MIT. La page du dépôt n’affiche pas de release ; le paquet se distribue par npm (
ruflo). - Positionnement : « Agent = modèle + harnais ». Le modèle écrit ; le harnais fournit outils, mémoire, boucles, bacs à sable et contrôles. Ruflo se veut ce harnais autour de Claude Code et Codex.
- Fonctions annoncées : plus de 100 agents spécialisés, essaims (topologies hiérarchique, maillée, adaptative, avec consensus), mémoire persistante avec index vectoriel, routage entre plusieurs fournisseurs de modèles, « federation » entre machines, une console visuelle et une interface terminal.
- Intégrations : plugins Claude Code (nécessite Claude Code 2.1.287 ou plus récent), serveur MCP pour Codex et d’autres clients.
Un avertissement de lecture : le README donne plusieurs chiffres qui ne concordent pas (98 ou plus de 100 agents, 35 plugins ou 33 plus 21, etc.), et ses résultats de performance viennent de mesures du projet, publiées dans un lien externe. Ce sont des affirmations du projet, pas des mesures de span.observer.
Installer Ruflo d’après le README
Étape 1 — Dans Claude Code
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo
Le README décrit Core (outils de base), Console (le tableau de bord) et Mods (routage et application de règles à l’intérieur de Claude Code). Pour le fonctionnement du catalogue de plugins, voir notre article sur claude-plugins-official.
Étape 2 — Avec Codex ou un autre client MCP
npx ruflo@latest init wizard
npx -y ruflo@latest mcp start
Le README indique, pour un client qui accepte les serveurs MCP locaux en stdio, la commande npx avec les arguments ["-y", "ruflo@latest", "mcp", "start"]. Il précise que la console et les mods sont des intégrations Claude Code et que la prise en charge des hooks dépend du client.
Étape 3 — Interface terminal, sans Claude Code
npx ruflo tui
npx ruflo tui --plain
L’option --plain imprime une image fixe, utile pour des scripts. Le README indique que l’installation par script curl | bash demande un shell POSIX : sous Windows, utilisez la forme npx.

La console : voir ce que font les agents
Le README décrit la console comme un « cockpit d’agents » : workflows, agents, modèles, tokens et coût. Une démonstration montre Claude Code pilotant la console par des outils MCP, avec un panneau « Claude control » qui liste les actions réalisées.

Le README prévient que cette animation utilise des données d’exemple et ne montre pas un travail d’essaim terminé ni un rappel de mémoire. Il décrit aussi des niveaux de contrôle pour Claude sur la console (lecture, écriture, gestion, complet), avec approbation « ask » ou « auto », le réglage par défaut étant lecture avec demande ; les actions réseau, de dépense ou destructrices exigent une confirmation même en mode auto.
Superviser un essaim d’agents
Plusieurs agents qui travaillent en parallèle multiplient les appels de modèles. Les outils de Ruflo donnent un premier niveau de lecture : la page Cost de l’interface terminal et le plugin ruflo-cost-tracker, que le README décrit comme suivant l’usage des tokens, les budgets et les alertes de coût.
- Coûts. Comparez ce que montre Ruflo avec la console de votre fournisseur de modèles, comme dans le coût d’un agent IA avec OpenTelemetry.
- OpenTelemetry. Dans le README lu, je n’ai pas trouvé d’export OpenTelemetry documenté. Avant de promettre des traces dans votre backend, vérifiez la documentation du projet ; sinon instrumentez les agents eux-mêmes, voir l’observation des agents MCP.
- Droits. Le README avertit que les mods ne sont pas isolés : ils tournent avec les droits de votre compte et leur code est à lire avant installation. Voir les garde-fous en production et NVIDIA OpenShell pour isoler l’exécution.
Comment vérifier que ça fonctionne
- Après
/reload-pluginset/ruflo, la console s’ouvre et la page Overview s’affiche. - Une tâche courte confiée à un agent apparaît dans les pages d’activité et de coût ; la ligne d’état du terminal montre le coût de la session.
- Le README mentionne une commande
ruflo verifypour comparer les fichiers installés à un témoin signé : à essayer sur une installation de test.
Limites et points ouverts
- Chiffres non cohérents. Nombre d’agents, de plugins et de fournisseurs varie dans le README ; un compteur de téléchargements est marqué « illustratif ». Ne reprenez pas ces chiffres sans les vérifier.
- Performances déclarées. Les comparaisons avec d’autres frameworks viennent d’un document publié par le projet ; aucune mesure indépendante ici.
- Périmètre large. Mémoire vectorielle, federation entre machines, conformité (HIPAA, SOC2, RGPD annoncés), trading, IoT : beaucoup de surface pour un seul dépôt. Commencez par une fonction.
- Suivi des incidents. La section Support du README renvoie vers les tickets du dépôt
ruvnet/claude-flow, pas deruvnet/ruflo: vérifiez où signaler un problème. - Double chargement. Le README signale qu’activer la flotte Agentic QE depuis deux marketplaces la charge deux fois.
Bonnes pratiques
- Essayez d’abord Core et la console sur un projet de test, avant les mods.
- Gardez la console de Claude en lecture avec approbation tant que vous n’avez pas besoin de plus.
- Fixez un budget de tokens avant de lancer un essaim.
- Lisez le code des mods et épinglez les versions de
ruflo. - Traitez un essaim qui boucle comme un incident de fiabilité : arrêtez, regardez les coûts, corrigez la consigne.
Questions fréquentes
Ruflo remplace-t-il Claude Code ?
Non. Selon le README, Ruflo s’ajoute à Claude Code ou à Codex comme couche de coordination. Pour comparer avec un autre orchestrateur, voir Paperclip.
Ruflo est-il gratuit ?
Le code est sous licence MIT. Les appels aux modèles sont facturés par le fournisseur choisi ; le README mentionne aussi un bureau hébergé distinct, ruOS, accessible par une adresse MCP.
Faut-il Claude Code pour l’utiliser ?
Pas nécessairement : le README décrit une installation par npx et un serveur MCP pour Codex ou d’autres clients, et une interface terminal autonome. La console visuelle et les mods sont des intégrations Claude Code.
Conclusion
Ruflo propose un harnais ambitieux pour coordonner des agents de code, avec une console de suivi des coûts et de l’activité. Sa popularité ne remplace pas la vérification : relisez les chiffres du README comme des déclarations, limitez les droits des mods, et mesurez vous-même les coûts avant d’automatiser.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes dans le README officiel (github.com/ruvnet/ruflo).