sfs - birden fazla AI ajanının paylaştığı ortak beyin (shared brain) dosya sistemi

Merhaba. Claude Code ve Codex gibi AI ajanlarını birden fazla cihazda/oturumda çalıştırırken, her ajanın bağlamı ayrı ayrı birikiyor ve dün bir ajanın düzenleyip bıraktığı şeyleri bugün başka bir cihazdaki ajanın bilmemesi can sıkıcı olduğu için bunu geliştirdim.

Temel konsept, "birden fazla ajanın paylaştığı ortak beyin (shared brain)".

Birden fazla ajan aynı klasörü (ör. ./shared) paylaşırsa, wiki, bellek dosyaları, plan dokümanları ve iş artefaktlarının hepsi tek bir ortak beyinde toplanıyor. Bir ajanın yazdığı kararları başka bir cihazdaki/oturumdaki ajan aynen okuyabiliyor ve kimin hangi cihazda ne zaman neyi değiştirdiği izlenebiliyor.

Kullanım örnekleri:

• Support agent ile Engineering agent'ın birlikte paylaştığı müşteri sorunlarına ilişkin bağlam
• Mac mini ve Macbook arasında dosya/klasör değişikliklerini paylaşma
• Ekip üyelerinin kendi agent'ları üzerinden ortak olarak büyüttüğü şirket wiki'si (company brain)

sfs, herhangi bir klasörü senkronizasyon volume'ü olarak mount etmenizi sağlar:

$ sfs mnt ./shared --remote s3://my-bucket/workspace  

Mount edilen klasördeki dosyalar, diskte duran gerçek dosyalardır; bu yüzden tüm editörler/araçlar/ajanlar bunları ayrı bir entegrasyon olmadan doğrudan kullanabilir. Başka bir cihazda aynı remote ile mount ettiğinizde, aynı dosyalar oraya da gelir.

Başta "Google Drive gibi bir şey kullansam olmaz mı?" diye düşündüm ama bunu gerçekten ajan workspace'i olarak kullanınca şu sorunlar ortaya çıktı:

• Google Drive, diskten tasarruf etmek için yerel dosyaları sık sık offload ediyor; bu yüzden ajan bir dosyayı okumak istediğinde onu yeniden buluttan indirmesi sık yaşanan bir durum oluyor
• Streaming mount yaklaşımı kullandığı için Claude dosyayı yüklerken sık sık blocking yaşanıyor
• Zaten AI ajanı workflow'ları için tasarlanmış bir araç değil (insanın GUI'de tıklayarak kullanması varsayılıyor)

sfs, tüm dosyaları her zaman yerel diskte gerçek haliyle tutuyor (offload yok) ve arka planda senkronize ettiği için ajanlar bunları normal dosyalar gibi anında okuyup yazabiliyor.

Başlıca özellikler:

• Bulut depolama entegrasyonu: S3, GCS
• Değişiklik takibi: sfs log ile kimin/ne zaman/hangi cihazdan hangi dosyayı değiştirdiğini görebilirsiniz. İçerik adreslemeli depolama sayesinde üzerine yazılmış/silinmiş dosyaların içeriği de korunur
• Offline-first: Ağ bağlantısı olmasa da klasör tamamen kullanılabilir, bağlantı geri geldiğinde otomatik push edilir
• Çakışma güvenliği: Eşzamanlı düzenlemeler (lamport, time, device) sırasına göre deterministik olarak yeniden oynatılır
• macOS, Linux

Kurulum:

brew install runbear-io/tap/sfs  

Hâlâ erken bir sürüm olduğu için geri bildirimler/issues memnuniyetle karşılanır. Teşekkürler!