Claude Code ve Cursor aynı hafızayı paylaşsın: project-memory

Bir işi Claude Code'da yarıda bırakıp Cursor'da devam etmek istediğinde yeni ajan hiçbir şey bilmez. Ya her şeyi baştan anlatırsın ya da o kodu yeniden keşfetmesini beklersin. project-memory bu derdi çözmek için yazdığım ortak, yerel bir hafıza.

Nasıl çalışıyor?

1. Oturum bitince not düşer. Ajan anlamlı bir iş yaptıktan sonra projenin son durumunu küçük bir Markdown dosyasına (NOW.md) yazar: ne yapılıyordu, sırada ne var, hangi dosyalar önemli.
2. Yeni oturum oradan başlar. Claude Code ve Cursor'da yeni oturum açılınca bu not otomatik olarak yüklenir. Antigravity ve Codex de kuralı gereği önce bu notu okur. Ajan kod tabanını taramadan, git log kazmadan kaldığı yerden devam eder.
3. Konu notları gerektiğinde açılır. Her özellik için birkaç maddelik bir not tutulur; ajan yalnız işine yarayanı açar. Böylece oturum başına birkaç yüz token yeter.

Claude Code, Cursor, Antigravity ve Codex aynı notları okuyup yazar. Yani bir araçta yaptığın şey, ötekinde de bilinir.

Verin sende kalır

Bulut yok, üyelik yok. Bütün notlar bilgisayarındaki ~/ai-memory klasöründe, düz Markdown olarak durur. İstediğin zaman açıp okuyabilir, düzeltebilirsin.

Nasıl kurulur?

uvx ai-project-memory install

Kurulum, bilgisayarındaki araçları (Claude Code, Cursor, Gemini/Antigravity, Codex) kendisi bulur, neyi değiştireceğini gösterir ve onayını ister. pipx install ai-project-memory && project-memory install da aynı işi yapar. Python 3.9 ve sonrası yeterli; macOS'taki hazır python3 iş görür.

Kurulumdan sonra project-memory status komutu neyin nereye bağlandığını ve proje başına kaç token yüklendiğini gösterir.

uvx ai-project-memory install