okf-memory/okf-agent-memory
Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.
Hızlı değerlendirme
Özet
okf-agent-memory, AI coding agents için Git içinde saklanan ve gerektiğinde BM25 ile aranan kalıcı proje belleği sağlayan Go tabanlı bir araçtır.
Profiline uyum
MCP tabanlı kalıcı agent belleği ve BM25 araması, aktif kullandığınız agent ve MCP mimarileriyle doğrudan örtüşüyor.
Neden yükseliyor
22 günde 727 yıldız ve son 28 günde 162 commit dikkat çekiyor; dört farklı yazarın katkısı da yakın dönem geliştirme etkinliğine işaret ediyor. Ancak kısa geçmiş ve README'deki performans ile token tasarrufu iddiaları, bağımsız doğrulama olmadan benimsenme veya kalite kanıtı sayılmaz.
Problem
Agent oturumları arasında mimari kararların ve proje bilgilerinin kaybolmasını, tüm bilgiyi prompt içine koymanın oluşturduğu context bloat sorununu hedefliyor.
Çözüm
Bilgiyi OKF v0.2 biçimindeki Markdown ve YAML dosyalarında tutuyor; Go tabanlı BM25 arama, progressive disclosure ve gömülü MCP server ile gerekli içeriğin seçilerek alınmasını sağlıyor. Harici veritabanı gerektirmediği belirtiliyor.
Yenilik
Git tabanlı metin belleği ve lexical search tek başına yeni değil. Projenin ayırt edici yaklaşımı, OKF v0.2 knowledge bundle'ını BM25 ve MCP ile birleştirip normatif talimatları seçmeli semantik bellekten ayırması; bunun pratikte ne kadar üstün olduğu için henüz yeterli doğrulama görünmüyor.
Teknolojiler
- Go
- OKF v0.2
- BM25
- MCP
- Markdown
- YAML
- Git
Riskler
- Proje çok yeni; uzun dönemli bakım, uyumluluk ve gerçek kullanım hakkında kanıt sınırlı.
- README'deki sub-300µs arama ve %80 token azaltımı iddialarının bağımsız benchmark veya farklı projelerdeki sonuçları verilen bilgilerden doğrulanamıyor.
- BM25 lexical search, kullanıcı sorgusundaki terimlerle bellekteki ifadeler örtüşmediğinde ilgili bilgiyi bulamayabilir.
- OKF v0.2'ye ve projenin bellek düzenine bağımlılık, format veya araç değişikliklerinde geçiş maliyeti yaratabilir.
- Git ile taşınabilirlik sağlansa da bellek içeriğinin güncel ve doğru tutulması ekiplerin iş akışına bağlı.
Detaylı değerlendirme
Bu repo için detaylı değerlendirme henüz yapılmadı. Analiz, Ayarlar'daki uyum profilini hesaba katarak "bu işime yarar mı" sorusunu cevaplıyor. Bir kez çalışır; günlük koşular buna dokunmaz. Saatlik sınır var — bir kaynaktan en fazla 3 analiz.