Ruflo: eine Koordinationsschicht für Agententeams
ruvnet/ruflo · 73.247★ · 8.696 forks
Alles Wissenswerte über ruvnet/ruflo: einen Agenten-Harness, der Speicher, Schwarmkoordination, MCP, Plugins und Kontrollen zur Arbeit mit Claude Code und Codex hinzufügt.
Was Ruflo ist
Ruflo ist ein TypeScript-Projekt, das sich als „Meta-Harness” für Agenten präsentiert. Es ersetzt weder das Modell noch Claude Code oder Codex: Es legt eine Ausführungsschicht um sie, um spezialisierte Agenten zu orchestrieren, Speicher über Sitzungen hinweg zu bewahren, Hintergrundarbeiter zu aktivieren und Werkzeuge über einen MCP-Server bereitzustellen.
Das README unterscheidet zwei Ebenen. Die Installation der Claude-Code-Plugins fügt Slash-Befehle, Agentendefinitionen und einige Skills hinzu; die vollständige Initialisierung mit npx ruflo@latest init erstellt die Projektkonfiguration, registriert MCP, installiert Hooks und aktiviert den vollständigen Zyklus. Laut der Dokumentation des Repositorys besteht das Ziel darin, dass Nutzende nach dieser Initialisierung den Agenten weiterhin normal verwenden können, während die Hooks Aufgaben weiterleiten und Hintergrundarbeit koordinieren.

Der Ursprung: von Claude Flow zu Ruflo
Die GitHub-API datiert die Erstellung des Repositorys auf den 2. Juni 2025. Der sichtbare Hauptautor ist das Konto ruvnet, dessen Profil den Namen als rUv ausweist, auf Cognitum.One verweist und zum Zeitpunkt der Messung 199 öffentliche Repositories hatte. Die Namensgeschichte ist im README selbst dokumentiert: „Claude Flow” wurde in Ruflo umbenannt; der Text schreibt den Namen rUv zu und erklärt „Ru” als Verweis auf rUv und „flo” als Anspielung auf das Arbeiten bis spät in die Nacht.
Diese Änderung erklärt eine wichtige praktische Spannung: Die Dokumentation und einige Beitragslinks verwenden weiterhin den Namen Claude Flow und Pfade zu ruvnet/claude-flow, während der Vertrieb, das aktuelle Repository und die ausführbare Datei als ruflo angekündigt werden. Für eine Neuinstallation empfiehlt es sich, den aktuellen Pfaden von ruvnet/ruflo zu folgen und die installierte Version mit ruflo --version zu bestätigen.
Philosophie und Prinzipien
Der Ansatz geht von einer expliziten Trennung aus: „Agent = Modell + Harness.” Für Ruflo erzeugt das Modell Antworten, während der Harness Werkzeuge, Speicher, Schleifen, isolierte Umgebungen und Kontrollen beisteuert. Daraus ergeben sich vier in der Dokumentation beobachtbare Prinzipien:
- Koordination statt isolierter Sitzung: Es gruppiert Arbeiter in hierarchische, vermaschte oder adaptive Topologien und berücksichtigt Konsens.
- Persistenter Speicher und Lernen: Es verwendet AgentDB mit HNSW-Indizes; das README erklärt SONA-Muster, ReasoningBank und Trajektorienlernen.
- Automatisierung mit Nachvollziehbarkeit: Es kombiniert CLI, MCP, Hooks und Hintergrundprozesse; seine Anleitungen umfassen kryptografische Verifizierung installierter Artefakte.
- Sicherheit als operative Einschränkung: Es dokumentiert Zero-Trust-Föderation, Authentifizierung, PII-Entfernung und Auditierung. Dies sind vom Projekt erklärte Fähigkeiten, keine externe Zertifizierung.

Die Philosophie hat auch eine relevante Grenze: Das System erweitert die Angriffsfläche eines Agenten erheblich. Das README selbst listet mehr als hundert Agenten, MCP-Werkzeuge und Plugins auf; das Automatisierungsversprechen erfordert daher, dass das Team prüft, welche Hooks, Berechtigungen, Server und Hintergrundprozesse es akzeptiert.

Wie es funktioniert
Der dokumentierte technische Ablauf ist der folgende:
- Installation über
npx ruflo@latest init wizard,npx ruflo@latest initodernpm install -g ruflo@latest. - Für Claude Code den Server registrieren mit
claude mcp add ruflo -- npx ruflo@latest mcp start. - Einen Schwarm über die Befehle
swarm, Agenten und Speicher erstellen und betreiben; das Diagramm des READMEs fasst den Ablauf als CLI/MCP → Router → Schwarm → Agenten → Speicher → Modellanbieter zusammen. - Plugins für Koordination, Speicher/RAG, Tests, Sicherheit, Observability, Kosten oder Domäne wählen. Die Liste des READMEs umfasst unter anderem
ruflo-swarm,ruflo-rag-memory,ruflo-agentdb,ruflo-testgen,ruflo-security-auditundruflo-cost-tracker.

Die vollständige Ausgabe fügt laut der Schnellstart-Tabelle 98 Agenten, mehr als 60 Befehle, 30 Skills, einen MCP-Server, Hooks und einen Daemon hinzu. Um den MCP-Kontext zu begrenzen, zeigt die Dokumentation ruflo mcp start --tools memory,swarm,hooks. Das Projekt bietet außerdem eine Beta-Weboberfläche unter flo.ruv.io und einen GOAP-Planer unter goal.ruv.io; das README behauptet, beide seien selbst hostbar, aber diese Behauptung stammt vom Autor und nicht von einem unabhängigen Audit.

Die zuletzt abgerufene stabile Version war v3.34.0, veröffentlicht am 31. Juli 2026. Ihre Release Notes kündigen eine optionale Integration mit AGNTCY/Outshift an, Befehle wie ruflo transport use slim, ruflo agent publish und ruflo swarm join <namespace>, sowie eine CASA-Autorisierungsrichtlinie mit Deny-by-Default. Dieselbe Notiz gibt an, dass die Integration entfernbar ist und der Kern ohne diese Pakete funktioniert.
Offizieller und halboffizieller Status
Ruflo ist offiziell in Bezug auf seinen eigenen Plugin-Marktplatz: Das README weist an, ruvnet/ruflo als Claude-Code-Marktplatz hinzuzufügen und Pakete wie ruflo-core@ruflo zu installieren. Es wurde keine Quelle von Anthropic, OpenAI oder GitHub gefunden, die es als offizielles Plugin dieser Anbieter erklärt. Es sollte daher nicht als von diesen Unternehmen validiert, zertifiziert oder gepflegt dargestellt werden.
Eine erklärte Kompatibilität mit Claude Code und Codex besteht durchaus, und das Repository veröffentlicht ein npm-Paket sowie eine MCP-Schnittstelle. In der Praxis zeigen seine 66.876 Sterne und 7.973 Forks eine De-facto-Sichtbarkeit in der Nische der Agenten-Harnesse; das entspricht keinem formalen Standard und belegt für sich genommen weder Zuverlässigkeit noch produktive Nutzung.
Das Ökosystem
Repositories und Produkte des Autors
Die Recherche zum Konto ruvnet identifizierte verwandte Komponenten, mit Sternezahlen der GitHub-API vom 3. August 2026:
ruvnet/RuVectorerscheint im README von Ruflo als Basis für Vektorsuche und RAG verlinkt; Ruflo nutzt es über das Pluginruflo-ruvector. Hier wird keine Zahl angegeben, da sie nicht in derselben API-Antwort des Inventars abgerufen wurde.ruvnet/metaharness: 540 Sterne. Erzeugt spezialisierte Harnesse und kann Konfigurationen bewerten; Ruflo enthält das Pluginruflo-metaharnessund den Befehlruflo eject, um ein eigenständiges Kit zu extrahieren.ruvnet/rvm: 125 Sterne. Wird als virtuelle Maschine für das Zeitalter der Agenten beschrieben, geschrieben in Rust; das README von Ruflo erwähnt sie bei der Beschreibung isolierter Umgebungen.ruvnet/rufield: 25 Sterne. Teil des Portfolios des Autors, obwohl die abgerufene Quelle keine direkte technische Abhängigkeit von Ruflo belegt.- Die gehosteten Anwendungen
flo.ruv.ioundgoal.ruv.iosind als Chat-Oberfläche beziehungsweise GOAP-Planer verlinkt; der Oberflächen-Code wird im Repository selbst als enthalten angegeben.

Plugins, Erweiterungen und Community-Derivate
Das Repository bringt eine Familie von Plugins mit, nicht nur eine Liste kompatibler Werkzeuge: Orchestrierung (ruflo-swarm, ruflo-autopilot, ruflo-workflows, ruflo-federation), Speicher (ruflo-agentdb, ruflo-rag-memory, ruflo-rvf, ruflo-knowledge-graph), Qualität (ruflo-testgen, ruflo-browser, ruflo-docs), Sicherheit (ruflo-security-audit, ruflo-aidefence) und Domäne (ruflo-iot-cognitum, ruflo-neural-trader).
Die abgerufenen GitHub-Suchen liefern konkrete externe Erweiterungen:
marcuspat/turbo-flow(166 Sterne): eine Umgebung für DevPods und Codespaces, die Ruflo-Orchestrierung, MCP-Werkzeuge und Agenten angibt.ai-genius-automations/openflow: ein Dashboard zur Verwaltung von Claude-Code-Sitzungen mit Ruflo; es erschien auf Hacker News.pacphi/agentic-kit(26 Sterne): ein Installer, der die Integration von Ruflo/Claude Flow, Agentic QE und RuvNet Brain über mehrere Hosts hinweg angibt.jazz-max/ruflo-hub(4 Sterne): ein Container zur Zentralisierung eines Ruflo-MCP-Servers mit PostgreSQL/RuVector.mamalisk/copilot-flow(4 Sterne): wird als Port von Ruflo/Claude Flow für GitHub Copilot beschrieben.aleksander-del/ruflo(9 Sterne): ein erklärter Fork vonruvnet/ruflo.

Es wurde keine nicht-englische Übersetzung von Ruflo gefunden, die explizit als solche gekennzeichnet ist. Ergebnisse mit bloßer Namensübereinstimmung, wie henryalouf/ruflow, sollten ebenfalls nicht mit einem verifizierten Port oder Derivat verwechselt werden.
Zahlen zum Repository
Messung: 3. August 2026, GitHub-API.
| Metrik | Wert |
|---|---|
| Sterne | 66.876 |
| Forks | 7.973 |
| Reale Abonnenten | 428 |
| Commits | 7.302 |
| Von der API angegebene offene Issues | 765 |
| Hauptsprache | TypeScript |
| Lizenz | MIT |
| Erstellung | 2. Juni 2025 |
| Letzter Push zum Repository | 2. August 2026 |
| Letzte Metadaten-Aktualisierung | 3. August 2026 |
| Letzte abgerufene stabile Veröffentlichung | v3.34.0, 31. Juli 2026 |
Die Gesamtzahl von 7.302 Commits stammt aus dem letzten Paginierungslink der Commits-API. Die von der API zurückgegebenen Hauptbeitragenden waren ruvnet (6.853 Beiträge), claude (50), alexx-ftw (7), proffesor-for-testing (5) und tommy-ca (4). GitHub dupliziert die Sterne in watchers_count; deshalb wird hier subscribers_count als reale Abonnentenzahl angegeben. Das Feld open_issues_count kann offene Pull Requests einschließen, sodass 765 nicht zwangsläufig eine reine Issue-Zählung ist.
Wie man beiträgt
CONTRIBUTING.md hält einen kurzen, überprüfbaren Ablauf ein: eine Issue oder Diskussion eröffnen, einen Fork und Feature-Branch erstellen, npm test ausführen und einen Pull Request mit klarer Beschreibung einreichen. Für die Entwicklung verlangt es Node.js 20 oder höher und npm 9 oder höher; danach schlägt es npm install und npm run build vor. Es verweist zudem agentengeführte Abläufe auf CLAUDE.md und Architekturentscheidungen auf docs/adr/.
Das Fortbestehen des früheren Namens im Beitragsdokument macht es ratsam, den Zielpfad des Pull Requests vor dessen Eröffnung zu prüfen. Aktuelle Änderungen zeigen, dass das Projekt Regressionstests und Veröffentlichungen mit Installationsprüfungen pflegt, aber das ersetzt nicht, die Tests im konkreten Fork auszuführen.

Wie die Community reagierte
Die abgerufene externe Resonanz ist begrenzt und sollte mit Vorsicht gelesen werden. Es gibt Anzeichen von Interesse und erklärter Nutzung, aber keinen breiten Thread, aus dem sich ein Konsens ableiten ließe:
- Bei Hacker News 49051072 reichte ms7892 das Repository am 25. Juli 2026 ein. Es erreichte 3 Punkte und 0 Kommentare: Das belegt Entdeckung, keine Bewertung durch die Community.
- Bei Hacker News 47943679 fragte chunpaiyang, ob jemand es nutze; die Einreichung blieb bei 1 Punkt und 1 Kommentar. Der Autor der Einreichung selbst sagte, die Idee erscheine ihm interessant und er nutze sie, um Unterbrechungen bei KI-gestützter Programmierung zu reduzieren; das ist eine persönliche Erfahrung, kein Ergebnisnachweis.
- In einem Kommentar von adithyaharish innerhalb von Hacker News 48473845 gab er an, es seit über drei Monaten zu nutzen, empfahl es für Orchestrierung und sagte, es funktioniere gut für ihn. Das ist konkretes, zurechenbares Lob, aber es wurde keine unabhängige Bewertung seiner Kosten oder Ergebnisse gefunden.
- akarshhedge2002 empfahl auf Hacker News 48463808 Ruflo zusammen mit Superpowers und erklärte, es habe seinen Kontextverbrauch stark reduziert. Auch das ist ein individuelles Zeugnis ohne veröffentlichte Methodik.
- Als technischer Gegenpunkt dokumentierte das von
ruvneteröffnete Issue #2047, dass eine geplante Verifizierung 95 fehlende Artefakte und zwei Hash-Abweichungen in Manifesten auf drei Plattformen fand; es wurde am 9. Juli 2026 geschlossen. Eine weitere Release-Notiz, v3.32.40, räumt ein, dass ungültige Werte bestimmterruflo security scan-Flags vor der Korrektur einen sauberen Bericht und Exit-Code 0 erzeugen konnten. Das sind vom Projekt dokumentierte Probleme, keine externen Angriffe; sie dienen als Grund, eine Installation zu aktualisieren und zu überprüfen, bevor man sich auf Sicherheitsautomatisierung verlässt.

Ruflo im Vergleich zu anderen Ansätzen
| Ansatz | Überprüfbare Übereinstimmung | Überprüfbarer Unterschied |
|---|---|---|
| Claude Code ohne Ruflo | Beide können KI-gestützte Programmierarbeit ausführen. | Das README von Ruflo fügt MCP, persistenten Speicher, Schwärme, Hooks und Hintergrundarbeiter hinzu; natives Claude Code ist kein eigenständiges konkurrierendes Repository, sondern der Host, den Ruflo erweitert. |
| Codex ohne Ruflo | Beide dienen als Umgebung für Code-Agenten. | Ruflo erklärt eine duale Installation für Claude Code und Codex mit einer gemeinsamen Koordinationsschicht; Codex wird von der Quelle nicht als Schwarmsystem charakterisiert. |
obra/superpowers | Beide werden in der HN-48463808-Konversation als Wege genannt, die Nutzung von Claude Code zu strukturieren. | Die abgerufene Quelle belegt nur diese Erwähnung: Sie erlaubt keine Aussage über technische Gleichwertigkeit. Ruflo dokumentiert explizit MCP, Speicher, Föderation und Plugins; Superpowers sollte separat bewertet werden. |
mamalisk/copilot-flow | Seine Beschreibung stellt es als Port von Ruflo/Claude Flow für GitHub Copilot dar. | Es ist eine Community-Anpassung für einen anderen Host, kein verifizierter eigenständiger Ersatz. |
Die sinnvolle Wahl hängt vom Umfang ab: Ruflo ist sinnvoll, wenn Koordination, persistenter Zustand und Plugins rund um einen Agenten benötigt werden; wer nur einen Anweisungsfluss sucht, für den kann das Laden der gesamten Infrastruktur unverhältnismäßig sein. Diese letzte Schlussfolgerung ist eine Analyse auf Basis der dokumentierten Bandbreite an Komponenten, keine vergleichende Messung.
Anwendungsfälle und wem dieses Repository helfen kann
- Teams, die mit Claude Code oder Codex an Repositories mit parallelen Aufgaben arbeiten, können
swarm, spezialisierte Agenten und die Koordinationstopologie nutzen, um Recherche, Umsetzung, Tests, Review oder Dokumentation aufzuteilen und dabei gemeinsamen Speicher zu bewahren. - Verantwortliche für Automatisierung mit sitzungsübergreifendem Kontext können
ruflo-agentdb,ruflo-rag-memoryund den MCP-Server nutzen, um Projektinformationen zu speichern und abzurufen, wobei stets geprüft werden sollte, welche Daten in den Speicher gelangen und welche Werkzeuge exponiert bleiben. - Teams mit Budget- oder Governance-Grenzen können
ruflo-cost-tracker,ruflo-security-audit,ruflo-aidefence, Protokolle und Artefaktverifizierung als Bausteine eines Kontrollprozesses einsetzen; die dokumentierten Issues und Korrekturen zeigen, dass sie das Gesamtsystem aktualisieren und validieren müssen, statt eine saubere Ausgabe für ausreichend zu halten. - Organisationen mit Agenten in verschiedenen Teams oder auf verschiedenen Maschinen können
ruflo-federationbewerten, wenn sie Discovery, Authentifizierung, PII-Kontrollen und Auditierung benötigen. Das ist besonders relevant, wenn sie das Vertrauensmodell in einer nicht-produktiven Umgebung testen können, bevor sie echte Daten übertragen. - Personen, die Funktionen schrittweise ausprobieren möchten, können nur die Claude-Code-Plugins installieren; wer MCP, Speicher und Hooks benötigt, braucht die vollständige Initialisierung und muss deren zusätzliche Dateien und Prozesse im Arbeitsbereich akzeptieren.

Ressourcen
- Repository: https://github.com/ruvnet/ruflo
- Dokumentation und Installation: https://github.com/ruvnet/ruflo/blob/main/docs/USERGUIDE.md
- Offizielle Plugins des Projekts: https://github.com/ruvnet/ruflo/tree/main/plugins
- Plugin-Marktplatz des Projekts: https://github.com/ruvnet/ruflo
- npm-Paket: https://www.npmjs.com/package/ruflo
- Veröffentlichungen und Versionen: https://github.com/ruvnet/ruflo/releases
- Rezensionen und Gespräche: https://news.ycombinator.com/item?id=49051072, https://news.ycombinator.com/item?id=47943679, https://news.ycombinator.com/item?id=48473845, https://news.ycombinator.com/item?id=48463808
- Discord-Community: https://discord.com/invite/dfxmpwkG2D
Hinweis: Dieser Artikel kombiniert das README sowie die Beitrags- und Release-Dokumente von Ruflo, die GitHub-API, Repository-Suchen und Hacker News, abgerufen am 3. August 2026. Zahlen ändern sich mit der Zeit; vom Projekt erklärte Fähigkeiten und Ergebnisse sind kein unabhängiges Audit.
Kommentare