Ruflo (Claude Flow) nedir? Ajan ekibi kiti, kurulum, hook'lar ve güvenlik bildirimi

Ruflo (eski adı Claude Flow), README'nin kendi tanımıyla Claude Code ve Codex için bir ajan meta-harness'ı: kurduğunda ajanlarına çoklu ajan koordinasyonu, kalıcı hafıza, hook'lar ve bir konsol gelir. Claude Code'a eklenti pazarından ya da `npx ruflo@latest init wizard` ile kurulur; MIT lisanslı, hesap istemez, ajanların çağırdığı modelin maliyeti senin sağlayıcında. Kurmadan önce bil: sayılar (eklenti, araç, komut) README, STATUS.md ve dizinde birbirini tutmuyor; eklenti yolunda hook yok denmesine rağmen ruflo-core hook kuruyor; hız ve doğruluk iddiaları yapımcının kendi tabloları.

Ne yapar: Claude Code ve Codex'te birden çok ajanı birlikte yürütür
Tür: Kit: eklentiler, ajanlar, skill'ler, hook'lar, MCP, konsol
Nerede: Claude Code (birincil), Codex, MCP istemcileri
Gereksinim: Claude Code 2.1.287+ ve Node.js 20+
Güvenlik: Kritik bildirim var (CVE-2026-59726), 3.16.3'te düzeltildi
Türkçe: Resmî kaynak yazmıyor
Ücret: Ücretsiz (MIT); model maliyeti senin sağlayıcında

Ruflo ne işe yarar? İçinde ne var?

Ruflo, Claude Code'a ek bir katman getiriyor: büyük bir işi birden çok ajana bölüp koordine etmek (swarm), oturumlar arası hafıza ve geçmiş görevlerden öğrenme, hook'larla komut ve dosya yazımlarına bağlanma ve ajan işlerini izlemek için bir konsol. README, ajanların yine de bir dil modeli çağırdığını ve maliyetin bağladığın sağlayıcıdan geldiğini yazıyor. MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır.

Birden çok ajanla çalışmakNe alırsın: Koordine edilmiş ajan çalışması; sonuç kalitesi bağımsız ölçülmemişAyrı kurulum gerekir Oturumlar arası hafızaNe alırsın: Yerel hafıza veritabanıAyrı kurulum gerekir

Parçaların sayısı kaynaklara göre değişiyor, bu yüzden tek sayı verilmiyor:

Kaynak	Eklenti	MCP aracı	CLI komutu
README	"All 35 plugins"; "33 native + 21 npm"	314	26
STATUS.md (3.10.2 anlık görüntüsü)	33	323	45
Depo dizini	marketplace.json 46 kayıt; plugins/ altında 47 klasör	ruflo-core: "300+"	—

README ayrıca init yolunda 98 ajan, 30 skill ve 60+ komut yazıldığını söylüyor. Kime yarar: Claude Code ile uzun, çok adımlı işler yapan ve ajan koordinasyonunu denemek isteyenlere. Küçük işlerde gereksiz ağırlık getirebilir.

Ruflo nasıl kurulur?

İki ana yol var ve yüzeyleri çok farklı: eklenti yolu (README'de "hafif") ve init yolu ("tam döngü"). Komutlar README'den aynen alındı.

1. Pazarı ekle› /plugin marketplace add ruvnet/ruflo

2. Yalnız çekirdek› /plugin install ruflo-core@ruflo

README'nin tam yolu ayrıca ruflo-console ve ruflo-mods eklentilerini kurup /reload-plugins ve /ruflo komutlarını çalıştırmanı söylüyor. Swarm ve hafıza gibi parçalar ayrı eklentiler (ruflo-swarm, ruflo-rag-memory).

ruflo-mods eklentileri hesabının yetkileriyle ve sandbox'sız çalışır (README); kurmadan önce kodunu oku.

Sihirbaz (tüm işletim sistemleri)› npx ruflo@latest init wizard

Bu yol çalışma klasörüne .claude/, .claude-flow/ ve CLAUDE.md yazar; ajanlar, komutlar, skill'ler, MCP, hook'lar ve bir arka plan süreci (daemon) kurar. README geri alma komutu vermiyor.

Claude Code'a MCP sunucusu› claude mcp add claude-flow -- npx ruflo@latest mcp start

Başka bir MCP istemcisinde komut npx, argümanlar ["-y", "ruflo@latest", "mcp", "start"].

macOS, Linux, WSL, Git Bash› curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

Bu komut ana daldaki betiği indirip doğrudan çalıştırır. Çalıştırmadan önce betiği indirip oku.

Önce ruflo-core ile başla; ihtiyaç duydukça tek tek ek eklenti ekle. init yolu projene çok dosya yazıyor.

Ruflo nasıl kullanılır?

Eklentilerle gelen skill ve komutlar Claude Code içinde çağrılır; durumu ve kurulumu görmek için ruflo-core şu komutları getiriyor: ruflo-status, witness, ayrıca doctor ve init-project skill'leri.

Durumu gör"/ruflo-status Ruflo kurulumum sağlıklı mı? Hangi eklentiler ve hook'lar etkin, listele."

Ajan ekibiyle çalış"ruflo-swarm eklentisini kullanarak bu özelliği üç ajana böl: biri kodu yazsın, biri test yazsın, biri incelesin. Başlamadan önce planı bana göster."

Terminal arayüzü (isteğe bağlı)› npx ruflo tui

README'deki "yüzde 89 yönlendirme doğruluğu", "2,8-4,4 kat hız" ve "yüzde 30-50 token tasarrufu" gibi sayılar yapımcının kendi tablolarından geliyor; yöntem, veri kümesi ya da bağımsız doğrulama yok. Kendi işinde ölç.

Ruflo hangi programlarda çalışır?

Claude CodeVar	Eklenti pazarı, hook'lar, konsol; 2.1.287 ve üstü.
CodexKısmen	npx kurulumu ve MCP sunucusu; hook desteği istemciye bağlı. Bir sürüm notu "Codex MCP backend retired" diyor; ne anlama geldiğini not açıklamıyor.
Diğer MCP istemcileriNet değil	README yalnız "MCP enabled tool" diyor, belirli istemci adı listelemiyor.

Ruflo neye erişir, hook'lar ne çalıştırır?

Hook'lar

README tablosu eklenti yolunda hook olmadığını yazıyor, ama ruflo-core eklentisi hooks.json ile 9 hook komutu kuruyor (kaynak dosyaya göre): Bash ve dosya düzenlemelerinden önce ve sonra, bağlam sıkıştırmada ve oturum sonunda. Betik her zaman izin verip 0 koduyla çıkar, yani turu engellemez.

Okur

Proje dosyaların ve çalıştırdığın Bash komutların (hook olay verisi), oturum geçmişi ve kendi hafıza veritabanı.

Yazar

init çalışma klasörüne .claude/, .claude-flow/ ve CLAUDE.md yazar. Hafıza ve öğrenme kayıtları diske yazılır; hafıza şifrelemesi varsayılan olarak kapalı. Federasyon ve tarayıcı araçları dışarıya istek gönderebilir.

Dışarı giden veri

hooks.json hook'lara "telemetry" diyor ve olayı yerel komuta iletiyor; komutun veriyi dışarı gönderip göndermediğini belgeler netleştirmiyor.

Sürüm sabit değil: yerelde kurulu değilse hook npx ruflo@latest, MCP başlatıcısı npx @claude-flow/cli@latest çalıştırır; yani her seferinde en yeni yayın gelir. RUFLO_HOOK_SKIP_NPX=1 ve RUFLO_MCP_SKIP_NPX=1 bunu engeller. Hook'lar arka planda ayrı süreçler olarak başlar (aynı anda en çok 4).

Depoda yayımlanmış kritik bir güvenlik bildirimi var: GHSA-c4hm-4h84-2cf3 (CVE-2026-59726), "MCP köprüsünün varsayılan docker-compose dağıtımında kimlik doğrulamasız uzaktan kod çalıştırma". Etkilenen sürümler 3.16.3'ten öncesi; 3.16.3'te yamalandı (1 Temmuz 2026). Güncel sürüm bundan etkilenmiyor görünüyor ama bu "güvenli" demek değildir. Projenin SECURITY.md destek tablosu yalnız 3.5.x'i "destekli" gösteriyor (güncellenmemiş olabilir). Depoda 1.000'den fazla açık issue var. Kurulumdan önce depoyu ve sürümü gözden geçir.

Ruflo ücretsiz mi?

Ruflo'nun kendisi evet: MIT lisanslı, hesap ya da abonelik istemiyor. Ancak ajanlar yine bir dil modeli çağırır; maliyet bağladığın sağlayıcıdan (örneğin Claude aboneliğin ya da API anahtarın) gelir ve çok ajanlı çalışmalar normalden fazla kullanım harcayabilir. TL fiyatı yok.

Yapabilirsin

MIT: kullanmak, değiştirmek, ticari işte kullanmak serbest

Yasak

README'de kurumsal yönetici izni anlatılmıyor

Kaynak: README ve LICENSE. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Windows'ta her araç çağrısında "PreToolUse hook (failed) exit code 1"	Eski bash tabanlı hook kaynaklı bir sorun (#2721) node tabanlı kabuğa taşındı; eklentiyi güncelle.
Hook'lar her komutu yavaşlatıyor	Betik yorumuna göre ölçülen gecikme 0,9 sn öncesi, 1,5-4 sn sonrasıydı (#4128); artık arka planda çalışıyor. `RUFLO_HOOK_SYNC=1` eski eşzamanlı davranışı geri getirir.
Eklenti ile elle kurulan npm sürümü farklı çıkıyor	MCP başlatıcısı önce yerel kurulumu arar, yoksa @latest çeker. `RUFLO_MCP_CLI_OVERRIDE` ile sabitlenebilir (#2971).
Kullanıcıların bildirdiği Hafıza araması tek sonuca düşüyor ya da yanlış gömme kullanılıyor	Açık issue'lar #4191 ve #4192 (14.10.2026); düzeltme beklemede.

Ruflo nasıl kaldırılır?

Eklenti yolunda: /plugin menüsünden ruflo-core, ruflo-console, ruflo-mods ve kurduğun diğer ruflo-* eklentilerini kaldır.
MCP olarak eklediysen: claude mcp remove claude-flow.
init ile kurduysan: Önce arka plan sürecini durdur (npx ruflo@latest daemon stop), sonra proje klasöründeki .claude/, .claude-flow/ ve CLAUDE.md'yi gözden geçirip elle sil; README geri alma komutu vermiyor.
Genel npm kurulumu: npm uninstall -g ruflo.

Sık sorulan sorular

Ruflo ile Claude Flow aynı şey mi?

Evet. README "Claude Flow is now Ruflo" diyor. Eski depo yeni adrese yönleniyor; README'deki bazı komutlar hâlâ claude-flow adını kullanıyor.

Eklenti mi kurmalıyım, npx ruflo init mi?

README'nin tablosuna göre eklenti yolu hafif, init yolu tam kurulum: ajanlar, komutlar, skill'ler, MCP, hook'lar, arka plan süreci ve çalışma klasörüne dosyalar. Tablo eklenti yolunda hook olmadığını söylüyor ama ruflo-core eklentisi hook kuruyor. Başlangıç için eklenti yolu ve yalnız çekirdek eklenti daha az dosya yazar.

Yüzde 89 isabet, 2,8-4,4 kat hız gibi sayılar doğru mu?

Bu sayılar README ve kullanıcı kılavuzunda yazıyor; ölçüm yöntemi, veri kümesi ya da bağımsız doğrulama yok. Yapımcı iddiası.

Güvenlik uyarısı var mı?

Evet, yayımlanmış bir tane: CVE-2026-59726 (kritik), MCP köprüsünün docker-compose dağıtımında kimlik doğrulamasız uzaktan kod çalıştırma; 3.16.3'ten önceki sürümler etkilendi, 3.16.3'te düzeltildi. Bu güncel sürümün güvenli olduğu anlamına gelmez.

Hook'lar ne çalıştırıyor, kapatabilir miyim?

ruflo-core, Bash ve dosya düzenleme araçlarından önce ve sonra, sıkıştırmada ve oturum sonunda yerel Ruflo komutunu çağıran hook'lar kurar. npx yedeğini kapatmak için RUFLO_HOOK_SKIP_NPX=1; eklentiyi kaldırmak hook'ları kaldırır.

Ücretsiz mi?

Ruflo evet (MIT, hesap yok). Ajanların çağırdığı modelin maliyeti senin hesabından düşer.

İlgili rehberler

Claude

Claude Code

Kaynaklar

Resmî kaynaklarda net olmayanlar: Parçaların güncel sayısı (README, STATUS.md ve dizin farklı) · hook'ların "telemetry" verisinin dışarı gidip gitmediği · hız, doğruluk ve token tasarrufu iddiaları (kanıtsız) · hafıza silme komutlarının kapsamı · Codex desteğinin kapsamı · OSV taraması (npm için boş döndü) · Türkçe bilgisi. Her biri ilgili bölümde yazılı.