Ruflo v3.38.9-Review: der Symlink-Fix und was vor dem Produktivbetrieb zu prüfen ist


Kurz gesagt: Ruflo (ruvnet/ruflo, früher Claude Flow) ist eine MIT-lizenzierte TypeScript-Agent-Meta-Harness, die Claude Code und Codex um Schwärme spezialisierter Agenten, persistenten Speicher, MCP-Tooling und Koordinations-Hooks ergänzt. Zum Stand des Snapshots vom 18. August 2026 lohnt sich die Evaluierung, wenn Sie bereits mit Claude Code oder Codex bauen und mehr Struktur für Multi-Agent-Arbeit wollen. Es ist noch keine Plug-and-Play-Produktionsplattform: Das Projekt veröffentlicht schnell und ändert Verhalten häufig, einige Statusmeldungen waren bis vor Kurzem irreführend, und die Leistungs-, Skalierungs- und Compliance-Aussagen in der README sind Behauptungen der Maintainer, die dieses Quellen- und Dokumentations-Review weder ausgeführt noch verifiziert hat.

Fakten auf einen Blick

Eintrag Wert
Review-Datum 18. August 2026
Projekt ruvnet/ruflo (früher Claude Flow)
Lizenz MIT
Sprache TypeScript
Stars 68.120 (Snapshot zum Review-Zeitpunkt)
Forks 8.168 (Snapshot zum Review-Zeitpunkt)
Offene Issues 837 (Snapshot zum Review-Zeitpunkt)
Letztes Release v3.38.9, veröffentlicht am 13. August 2026
Verifizierungsgrad Beobachtet: Quellen- und Dokumentations-Review

Was Ruflo ist und für wen es infrage kommt

Die Maintainer beschreiben Ruflo als „agent meta-harness for Claude Code and Codex“: die Ausführungsebene um diese CLIs, die spezialisierte Agenten, Swarm-Koordination, persistenten Speicher, Lernschleifen, MCP-Tooling, Föderation und Sicherheits-Guardrails ergänzt. Die README behauptet 100+ spezialisierte Agenten, einen Plugin-Marktplatz, Multi-Provider-Unterstützung (Claude, GPT, Gemini, Cohere, Ollama), Hintergrund-Worker, Vektor-Speicher und eine selbst hostbare Web-UI-Beta mit gehosteter Demo. Das Projekt hieß früher Claude Flow, und einige Pakete und Befehle verwenden weiterhin den Namen claude-flow.

Unter diesen Bedingungen würde ich Ruflo auf eine Shortlist setzen:

  • Ihr Team arbeitet bereits in Claude Code oder Codex und will koordinierte Multi-Agent-Läufe, gemeinsamen Speicher über Sitzungen hinweg und MCP-Integration statt einer separaten Agenten-Plattform.
  • Sie sind mit einer schnelllebigen TypeScript-Codebasis, häufigen Releases und einer großen Plugin-Oberfläche vertraut und können Versionen pinnen und eigene Regressionstests durchführen.
  • Sie können mit einem abgegrenzten Experiment beginnen – ein oder zwei Agenten plus Speicher – bevor Sie sich auf Swarms oder Föderation einlassen.

Verzichten Sie vorerst darauf, wenn Sie eine stabile, dokumentierte Plattform mit Supportvertrag brauchen oder Ihr Team den Änderungsdruck eines Projekts nicht verkraftet, das in zwei Tagen fünf Patch-Releases ausgeliefert hat (v3.38.5 bis v3.38.9, 12. bis 13. August 2026).

Was sich in v3.38.9 geändert hat

v3.38.9, veröffentlicht am 13. August 2026, ist ein schmaler Fix für PathValidator. Laut Release-Notes hat validate() Kandidatenpfade mit fs.realpath kanonisiert, während der Konstruktor erlaubte Präfixe nur mit path.resolve() aufgelöst hat. Unter macOS, wo os.tmpdir() über einen Symlink erreicht wird (/var → /private/var), konnte ein mit realpath aufgelöster Kandidat nie mit einem nicht aufgelösten Präfix übereinstimmen – jeder Pfad unter einem symlink-Präfix, einschließlich des Inhalts des Präfixes selbst, wurde daher als „outside allowed directories“ abgelehnt.

Der Fehler traf ruflo proxy install unter macOS, nachdem Download und Ed25519-Signaturprüfung bereits erfolgreich waren; die Release-Notes beschreiben die Pfadprüfung als Defense-in-Depth statt als Integritätsgrenze. Der Fix löst Präfixe zum Konstruktionszeitpunkt per realpath auf und verwendet denselben ENOENT-toleranten Fallback, den validate() bereits für Kandidaten genutzt hat.

Was das für Betreiber bedeutet:

  • Wenn Sie ruflo proxy install unter macOS mit v3.38.8 oder älter ausgeführt haben und „outside allowed directories“ gesehen haben, aktualisieren Sie auf v3.38.9 und versuchen Sie es erneut.
  • Wenn Sie eine ältere Version pinnen, rechnen Sie bei jedem symlink-Präfix mit diesem Fehler – nicht nur bei macOS-Temp-Pfaden.
  • Das Release ändert nur die Pfadvalidierung; es ändert weder das Agentenverhalten, den Speicher noch das Provider-Routing.

Was die jüngste Release-Kadenz signalisiert

Die Releases unmittelbar vor v3.38.9 sagen mehr über die Wartungsgesundheit aus als der Patch selbst. v3.38.8 hat die Weitergabe der Provider-/Modell-Konfiguration behoben: Eine explizite Provider- oder Modellwahl (zum Beispiel ein lokaler Ollama- oder OpenRouter-Endpunkt) wurde zuvor gespeichert, aber während der Ausführung ignoriert. CLI-Befehle konnten daher erfolgreich wirken, während die Ausführung fail-closed endete oder stillschweigend einen anderen Provider oder ein anderes Modell als angefordert verwendete. Wenn Sie einen Nicht-Standard-Provider konfigurieren, verifizieren Sie ab v3.38.8+, dass der Agent tatsächlich das von Ihnen Angegebene verwendet hat.

v3.38.7 war ein Fix für ehrlichere Statusmeldungen: Speicher-Statusfunktionen lieferten available: true und meldeten ein fest verdrahtetes Backend „sql.js + HNSW“, selbst wenn der Anforderungspfad eine Brute-Force-Cosinus-Suche statt eines HNSW-Index verwendete. Die umbenannten Funktionen melden jetzt den tatsächlichen Algorithmus. Die Release-Notes lassen die größere Aufgabe offen, echtes HNSW in den Standard-Suchpfad zu integrieren – behandeln Sie daher jede „HNSW“-Behauptung in der README als bedingt, bis Sie das Algorithmus-Feld zur Laufzeit beobachten.

Weitere aktuelle Fixes (v3.38.5 und v3.38.6) betrafen die ADR-Indizierung, die .brain überspringt, github_issue_track, das owner/repo-Argumente berücksichtigt, Secret-Detection-Regexes für gängige Stripe-/OpenAI-Schlüsselformen, einen Codex-stdin-Hang, veraltete Intelligence-Cache-Inhalte und Daemon-Konfigurations-Overrides, die durch eine veraltete daemon-state.json verloren gingen.

Die Wartung ist aktiv und Fixes erscheinen schnell; außerdem hat das Projekt zuletzt irreführende Statusmeldungen korrigiert. Zu den Warnsignalen gehören der Release-Rhythmus (fünf Patches in etwa zwei Tagen), 837 offene Issues zum Snapshot-Zeitpunkt und mindestens ein lange offenes Onboarding-Issue (#958, im Januar 2026 eröffnet und zum Snapshot-Zeitpunkt weiterhin offen), das Schwierigkeiten beschreibt, v3 wie dokumentiert arbeiten zu lassen. Ein älteres, vom Maintainer verfasstes Review von v2 (#108) dokumentierte lokale Build-Probleme; v3 ist zwar ein Rewrite, aber das Muster spricht dafür, die genauen Befehle gegen Ihre Umgebung zu verifizieren.

Deployment- und Upgrade-Fragen

Vor dem Produktivbetrieb sollten Sie diese Punkte verifizieren:

  • Installationspfad. Die README dokumentiert zwei Pfade mit unterschiedlichem Umfang: die Claude-Code-Plugin-Installation (Slash-Kommandos, wenige Skills, keine Workspace-Dateien) gegenüber der CLI-Installation über npx ruflo init (die volle Schleife: 98 Agenten, 60+ Befehle, 30 Skills, MCP-Server, Hooks, Daemon plus Workspace-Dateien). Laut README sollte die Produktionsnutzung den CLI-Pfad nehmen; auch die MCP-Toolnamen des Plugins unterscheiden sich (zum Beispiel mcp__plugin_ruflo-core_ruflo__memory_store statt bloßer Namen). Diagnostizieren Sie anhand des Pfads, den Sie tatsächlich installiert haben.
  • macOS-Pfade. Aktualisieren Sie vor proxy install unter macOS auf v3.38.9 – oder pinnen Sie eine ältere Version und rechnen Sie mit der PathValidator-Ablehnung.
  • Laufzeitstatus gegenüber tatsächlichem Verhalten. Prüfen Sie ab v3.38.7 das Algorithmus-Feld in den Speicherstatus-Antworten, um zu sehen, ob tatsächlich HNSW oder Brute-Force-Cosinus gelaufen ist; ältere Versionen konnten unabhängig davon HNSW melden.
  • Provider- und Modell-Routing. Bestätigen Sie ab v3.38.8+, dass eine explizite Provider-/Modell-Konfiguration berücksichtigt wird; ältere Versionen konnten stillschweigend einen anderen Provider oder ein anderes Modell verwenden.
  • Daemon-Status. v3.38.6 hat behoben, dass resourceThresholds-Overrides durch eine veraltete daemon-state.json verloren gingen; bestätigen Sie nach der Konfiguration, dass die Overrides einen Neustart überleben.
  • Web-UI. Laut README ist die Web-UI-Beta per Docker selbst hostbar (mehrstufiges Dockerfile mit eingebettetem Mongo und einer cloudbuild.yaml für Cloud Run), mit einer gehosteten Demo unter flo.ruv.io. Behandeln Sie sie als Beta.
  • Föderation und Compliance. Die README beschreibt Zero-Trust-Föderation mit mTLS und ed25519, PII-Stripping, verhaltensbasiertes Trust-Scoring und Compliance-Modi (HIPAA, SOC2, GDPR-Audit-Trails). Dieses Review hat für diese Funktionen keine Laufzeitbelege; wenn sie für Sie relevant sind, testen und prüfen Sie sie vor dem Produktivbetrieb selbst.

Einschränkungen und offene Fragen

Die wichtigste Einschränkung ist die Zuschreibung. Die Schlagzeilenzahlen der README stammen aus von Maintainern veröffentlichten Benchmark-Dokumenten, Audit-Unterlagen und Repository-Datendateien: Leistungsvergleiche gegen LangGraph, AutoGen und CrewAI (zum Beispiel Cold-Start-, Single-Turn- und RSS-Wins von 1,3× bis 1953×), Beschleunigungen bei der Vektor-Suche (~1,9× bis 4,7× oberhalb eines Crossover-Punkts mit recall@10 um 0,99), 89 % Routing-Genauigkeit und Download-Zahlen. Keine davon wurde für dieses Review unabhängig verifiziert.

Offene Issues zeigen, dass einige ambitionierte Behauptungen nicht ausgeliefert sind. Ein Forschungs-Issue vom Mai 2026 (#2156) räumt ein, dass HNSW+AgentDB keinen öffentlichen Benchmark-Score hat, dass keine zeitliche Abstraktionsschicht existiert und dass es noch keinen Benchmark-Harness für Agent-Fähigkeiten oder einen Skill-Lebenszyklus gibt; es schlägt einen simulativen Planungs-Router als ADR-131 mit Status „proposed“ vor. Das Epic für unbegrenzte Agenten-Swarms (#125) bleibt mit vielen nicht abgehakten Punkten offen, und das phasenweise Embeddings-Upgrade (ADR-121, verfolgt in Issue #2036) hatte zum Snapshot-Zeitpunkt offene Phasen. Das Projekt wirkt zudem weitgehend maintainer-getrieben mit agentengestützter Entwicklung – berücksichtigen Sie also Bus-Faktor und Support-Kontinuität bei der Langzeitplanung.

Alternativen und Bewertungsfragen

Das Benchmark-Dokument der Maintainer positioniert Ruflo gegen LangGraph, AutoGen und CrewAI, aber dieses Dokument ist von den Maintainern veröffentlicht, und dieses Review hat keine Vergleiche durchgeführt. Statt eine Alternative zu empfehlen, sollte die Entscheidung an diesen Fragen hängen:

  • Was kaufen Sie? Eine Harness innerhalb von Claude Code/Codex mit Speicher, Hooks, MCP-Tools und Multi-Agent-Läufen ist der Kernwert von Ruflo. Wenn Sie ein Framework brauchen, das unabhängig von diesen CLIs funktioniert, prüfen Sie, ob die CLI-gekoppelte Oberfläche zu Ihrem Stack passt.
  • Brauchen Sie jetzt Swarm- oder Föderationsfunktionen? Sie tragen das meiste Risiko und haben die geringste unabhängige Verifikation; ein minimales Setup mit einem Agenten plus Speicher testet den Kernwert.
  • Können Sie Release-Churn verkraften? Pinnen Sie exakte Versionen, verfolgen Sie Releases und planen Sie Budget für Regressionstests ein. Fünf Patches in zwei Tagen sind für dieses Projekt normal.
  • Wie ist Ihr Supportweg? GitHub-Issues, eine Discord-Community und ein Enterprise-Kontakt sind aufgeführt; bei 837 offenen Issues sollten Sie Self-Service-Troubleshooting einplanen.
  • Können Sie die Behauptungen reproduzieren, von denen Sie abhängen? Planen Sie Zeit für eigene Smoke-Tests von Installationspfad, Provider-Routing, Speichersuche und Kostenverfolgung ein, bevor Sie sich festlegen.

Fazit

Bedingte Empfehlung. Ziehen Sie Ruflo in Betracht, wenn Sie bereits in Claude Code oder Codex arbeiten, strukturierte Multi-Agent-Koordination und persistenten Speicher wollen und eine schnelllebige Codebasis mit großer Plugin-Oberfläche tolerieren können. Vor dem Produktivbetrieb: Version pinnen, Provider-/Modell-Routing und Speicheralgorithmus-Meldung verifizieren, auf Ihrem tatsächlichen Betriebssystem testen (insbesondere macOS-Pfadvalidierung) und bei Föderation eine eigene Sicherheits- und Compliance-Prüfung durchführen.

Verschieben Sie die Entscheidung, wenn Sie eine stabile, unterstützte Plattform, eine kleinere prüfbare Fläche oder Belege dafür brauchen, dass die Skalierungs- und Compliance-Behauptungen in Ihrer Umgebung halten.

Quellen

Wenn Sie Ruflo evaluieren oder einen Agent-Workflow planen, kann ich bei den Teilen helfen, die oft übersprungen werden: Versionen pinnen, den tatsächlichen Installationspfad klären, Smoke-Tests für Provider-Routing und Speicherverhalten schreiben und einen Upgrade-Plan entwerfen, der zu Ihrer Churn-Toleranz passt. Ich bin Xiang Peng bei XP812 und arbeite mit Gründern und Engineering-Teams an KI-Systemintegration, Deployment und Wartung.


Hilfe anfragen