ai-memory: Claude Code, Codex ve diğer kodlama ajanları için ortak hafıza

Kodlama ajanlarının çoğunun kendi hafızası var, ama o notlar tek makinede ve tek ajanda kalır: Claude Code'un kullanım hakkı bittiğinde Codex'e geçersen projeyi, denenip başarısız olan yolları ve açık soruları baştan anlatırsın. ai-memory hafızayı ajanın dışına alır; aynı projeye hangi ajanla, hangi makineden girersen gir aynı notlar ve aynı devir notu seni bekler.

MCP, asistanın kendi dışındaki bir servise ya da bilgisayarındaki bir programa bağlanmasını sağlayan ortak bağlantı biçimi. Bu sunucu köprünün ortasında durur: asistan isteği ona iletir, o da hedefe sorar ve cevabı geri getirir.

Ona bir şey hatırlatmana gerek yok: kayıt ajanın oturum olaylarıyla kendiliğinden yapılır. Notlar düz Markdown dosyalarıdır; Obsidian'da açabilir, elle düzeltebilir, grep ile arayabilirsin. Veritabanı bu dosyalardan yeniden kurulabilen bir dizindir.

Kime yarar: aynı projede birden çok ajan kullanan, kullanım hakkı dolunca ajan değiştiren, masaüstü ve dizüstü arasında gidip gelen ya da ekip arkadaşlarıyla aynı depoda çalışan yazılımcılar. Kurulum terminal ister; kod yazmayan biri için değil.

Hook, ajanın oturum olaylarında (istem, araç çağrısı, oturum sonu) çalışan küçük komuttur. Devir notu (handoff) bir sonraki oturuma bırakılan yapılandırılmış nottur; bir sahibi vardır ve yalnız bir kez üstlenilir. Varsayılan yol hiç model çağrısı yapmaz; bir model sağlayıcı eklersen oturum özetleri iyileşir ve anlamsal arama açılır.

Ayrıca çalışma alışkanlıklarını (paket yöneticin, test düzenin) öğrenip her yeni projede oturum başına varsayılan profil olarak koyar; deponun kendi kural dosyası bundan önce gelir. Kullanılmayan oturum notları ayarlanabilir bir takvimle temizlenebilir; içeriği yeniden yazan ya da düşüren kısaltma ve birleştirme varsayılan kapalı, eski hâller git geçmişinde kalır.

İki adım: programı kur, sonra ai-memory setup ile veri klasörünü, servisi ve ajan bağlantılarını hazırla. Setup bulduğu ajanları ve ne yapacağını önce gösterir, onay ister; --plan hiçbir şeyi değiştirmeden planı yazdırır.

Kurduktan sonra ajanlarını yeniden başlat ve birine "Bu proje hakkında ne hatırlıyorsun?" diye sor; README cevabın ai-memory'den gelmesini kurulumun işareti olarak veriyor. Devam eden bir projeye de eklenebilir: ilk oturum diskteki ajan geçmişini içe aktarır.

Gündelik kullanımda ai-memory'yi düşünmezsin; ajanı onun üzerinden başlatmak önerilen yol, çünkü eksik bağlantıyı ilk açılışta kendisi kurar ve oturum sürekliliği ekler.

İstemleri ajana Türkçe de yazabilirsin; aramanın Türkçe içerikte nasıl çalıştığı resmî kaynakta ayrıca anlatılmıyor (site yalnız Çince, Japonca, Korece için özel dizin olduğunu yazıyor).

Kaynak: README "Everyday use" ve "Quick start"; aimemory.sh; 29.10.2026. Örneklerin çıktısı belgenin anlattığı kadar tarif edildi.

Sunucuyu herkesin ulaşabildiği bir makinede (ev sunucusu, ofis ağındaki bir makine) çalıştırır, her makineyi ve her ekip arkadaşını ona yönlendirirsin. Bilgi proje bazında paylaşılır, kişisel devir notları kişiye özel kalır; her yazma kişiye atfedilir ve denetim kaydına girer. Çok kullanıcı, kişiye atıf ve denetim kaydı ücretli bir katman değil.

• Kimlik doğrulama adım adım sıkılaştırılır: ağ için erişim belirteci, kişi hesapları, hook'lar için OIDC cihaz girişi, ters vekil sunucuyla TLS.
• Kendi makinesi dışından insan girişi varsayılan olarak HTTPS ister.
• Tek kural: bir veri klasörünü yalnız bir sunucu kullanır, asla iki.
• Sunucuya ulaşılamazsa olaylar yerelde bekler; sunucu dönünce ai-memory recover.

!Uzak sunucuya bağlanınca ajanların yakaladığı her olay (istemler, araç çağrıları) o sunucuya gider; sitenin önerisiyle ekip denemesine hassas olmayan bir projeyle ve sunucuyu, hesapları, güncellemeleri ve yedekleri yönetecek biriyle başla.

Resmî site 35 kodlama ajanıyla çalıştığını yazıyor; README'deki destek tablosu her satırı CI'da sınanan birinci taraf entegrasyon olarak veriyor. Bir kısmı tam destek (MCP + hook'lar), bir kısmı yalnız MCP:

!Tanınan şifre ve anahtarlar kayıttan önce gizlenir ama süzgeç gizli metni kaçırabilir; hassas klasörleri deponun yakalama kurallarıyla ([capture], yol hariç tutma ya da izin listesi) dışarıda bırak.

Kaynak: DATA_HANDLING.md ve SECURITY.md (v3.2.9), aimemory.sh; 29.10.2026. Bu bir güvenlik denetimi ya da sertifika değildir.

Evet. Program açık kaynak, MIT lisanslı; kayıt yok, ücretli katman yok. Kayıt, arama ve devir notları model API anahtarı olmadan çalışır. İsteğe bağlı olarak bir model sağlayıcı (Anthropic, OpenAI, Gemini, yerel Ollama ya da LM Studio…) eklersen o sağlayıcı kendi hesabından ücretlendirir. Ekip sunucusunda makine ve yönetimi sana ait.

uninstall --apply yalnız ai-memory'nin kurduğu şeyleri kaldırır.

İkisi de notu düz Markdown dosyası olarak tutar ve ajana MCP ile verir. Farkları ne için yapıldıklarında:

ai-memory'nin README'si basic-memory'yi "Markdown dosyası asıl kaynak" fikrinin dayandığı projelerden biri olarak anıyor ve üstüne eklediklerini otomatik kayıt, arama dizini, ajanlar arası devir ve çok kullanıcılı paylaşım diye sayıyor. Kişisel notlarını asistana açmak istiyorsan basic-memory; kod projesinde ajanlar ve kişiler arası süreklilik istiyorsan ai-memory.