Claude Code, Obsidian vault üzerinden oturumlar arası kalıcı hafızaya kavuştu

Ne oldu

dev.to'da seestack adıyla yayın yapan bir geliştirici, Claude Code'a bir Obsidian vault üzerine inşa edilmiş kalıcı bir hafıza katmanı kazandıran claude-obsidian-memory adlı açık kaynak bir proje yayınladı. dev.to gönderisine göre amaç gayet net: Claude Code oturumları genellikle soğuk başlar, yani önceki çalışmaların arka planı olmadan devreye girer; proje de çalışma bağlamını agent'ın daha sonra geri okuyabileceği bir yerde saklayarak bu sorunu çözmeye bir girişim.

Yazar, kodu herkese açık bir GitHub deposunda yayınladı ve hem ilk kurulumu hem de canlı bir oturum kurtarma testini kapsayan tam bir anlatım videosu kaydetti; bu testte yeni bir oturum, önceki oturumun kaldığı yerden devam ediyor.

Sistem nasıl çalışıyor

Kurulum, hafıza deposu olarak bir Obsidian vault kullanıyor. Gönderiye göre vault birkaç kategoride materyal barındırıyor: geçmiş oturumlarda neler olduğunu kaydeden günlük kayıtları, bitmemiş görevlerin listesi, işe yaradığı kanıtlanmış komutlar ve yol boyunca biriktirilen beceriler ile script'ler.

Yeni bir oturum başladığında Claude Code, vault içinde arama yapabilir, mevcut çalışmayla ilgili dosyaları bulabilir, daha önceki bağlamı bunlardan yeniden inşa edebilir ve sıfırdan başlamak yerine görevi sürdürebilir. Yazar, sonucu oturum kurtarma (session recovery) olarak tanımlıyor: agent, etkili bir şekilde kendi çalışma durumunu, kendi yazdığı ya da kendi için yazılan notlardan yeniden canlandırıyor.

Temel olarak Obsidian kullanıldığı için hafıza, anlaşılmaz bir veritabanında değil, vault içindeki sıradan notlar olarak yaşıyor. Bunun pratik bir yan etkisi var: aynı materyal, standart bir not alma aracı kullanan insan tarafından da okunabilir ve düzenlenebilir; ayrıca vault, agent'a özel girdilerin yanı sıra başka bilgiler de barındırabiliyor. Yazar sistemin bitmiş ya da evrensel olduğunu iddia etmiyor — gönderi, kalıcı bağlam konusunda diğer geliştiricilerin neler yaptığını sorarak kapanıyor ve proje açık bir soruna verilen yanıtlardan biri olarak çerçeveleniyor.

Hedeflediği sorun

Oturumlar arası bağlam kaybı, agent tabanlı kodlama araçlarının tekrar eden sıkıntılarından biri. Uzun bir oturum, paylaşılan bir anlayış biriktirir — hangi yaklaşımın denendiği, neyin bozulduğu, neyin tamamlanmadığı — ve oturum sona erdiğinde bu anlayış buharlaşır. Kullanıcılar genellikle bunu elle yazılmış özet dosyalarıyla (örneğin CLAUDE.md kuralı) ya da her seferinde projeyi yeniden anlatarak telafi eder.

Bu proje, bu telafi yöntemini yapılandırıyor. Tek bir statik talimat dosyası yerine vault; geçmiş, bekleyen işler ve yeniden kullanılabilir komutlar için ayrı bölümleri olan süregiden bir kayıt olarak işlev görüyor. Anlatım videosundaki oturum kurtarma testi kilit gösteri: taze bir Claude Code örneğinin ilgili notları bulduğunu ve geliştiricinin arka planı yeniden vermesine gerek kalmadan yarım kalan bir göreve devam ettiğini gösteriyor.

Neden önemli

Proje kapsam olarak küçük ama yapay zekâ araçlarının canlı bir fay hattı üzerinde duruyor. Kodlama agent'ları çok oturumlu, çok günlük işler üstlendikçe bağlamı ileriye taşıyabilmek, hoş bir ek olmaktan çıkıp birinci sınıf bir gereksinim haline geliyor ve hem üreticiler hem kullanıcılar birçok farklı türde hafıza katmanı üzerinde denemeler yapıyor. Obsidian vault içindeki düz Markdown notlarına dayanan bir yaklaşım, şeffaflığıyla dikkat çekiyor: hafıza, agent'ı denetleyen kişi tarafından incelenebilir, taşınabilir ve düzenlenebilir durumda; bir üreticinin depolama biçiminin içine kilitli değil.

Zaten Obsidian kullanan ekipler için bunu deneme eşiği düşük ve yapı — günlükler, görev listeleri, komut başvuruları — başkalarının farklı agent'lara uyarlayabileceği bir şablon. Yazarın kapanış sorusu asıl niyeti ima ediyor: kalıcı bağlam hakkında, yanında çalışan kodu da barındıran bir sohbet başlatmak. Bir agent'ın üç oturum boyunca aynı hatayı yeniden keşfedişini izlemiş herkes, projenin hedeflediği sıkıntıyı hemen tanıyacaktır.