Super Agent Memory
GitHub
v1.0.2 · npm · sıfır bağımlılık

Ajanlarınız unutmasın.
Tokenlarınız boşa gitmesin.

Claude Code’da alınan bir karar, Codex, Gemini ve OpenCode’un bir sonraki açılışında bilinir. Tek SQLite dosyası, sunucu yok, API anahtarı yok, model çağrısı yok.

npm ile kurÖlçümleri görGitHub’da yıldızla
npmrelease0 depsMIT

Node.js 22.16+ (22.x) ya da 24+ gerekir. AWS SAM CLI ile çakışırsa sam-memory komutunu kullanın.

~/code/shop — zsh
$ npm i -g super-agent-memory
$ sam install
✓ claude-code  hooks · mcp · skill
✓ codex        hooks.json · config.toml · AGENTS.md
✓ gemini-cli   settings.json · GEMINI.md
✓ opencode     plugin · instructions
✓ cursor       hooks.json · mcp.json
self-test: ok

$ sam context
<memory project="shop">
conventions the user recorded:
- package manager: pnpm, never npm
decisions (newest wins):
- auth: JWT in an httpOnly cookie · 10-07
- test runner: vitest with --pool=forks · 10-07
</memory>  ≤320-token card
Tek bellek, her ajanClaude CodeCodex CLIGemini CLIAntigravityOpenCodeCursorWindsurfClineZedCopilotMCP
Neden başka bir bellek?

En çok yıldızlı 50 bellek reposunu inceledik. Aynı beş sorun çıktı.

Bellek her turda bağlama dökülüyor: tur başına binlerce token.
Bütçeli, kademeli bağlam: oturum başında ≤320 tokenlık proje kartı, yalnızca ilgiliyse ≤160 tokenlık hatırlatma.
Aynı anılar her turda yeniden gönderiliyor.
Oturum başına enjeksiyon defteri: bir anı aynı oturumda iki kez ödenmez.
Her yazma için model çağrısı (gözlemci LLM’ler).
LLM’siz yakalama: düzenlemeler, komutlar, hata→çözüm çiftleri belirlenimci; satır içi ⟦mem⟧ işaretleri araç çağrısı harcamaz.
19–54 araçlı MCP yüzeyleri, oturum başına binlerce şema tokenı.
Yalnızca 4 araç (~380–420 şema tokenı) ya da hiç MCP yok: her işlem bir kabuk komutu.
Test ve derleme çıktıları bağlamı boğuyor.
Çıktı kasası: sam run -- npm test tam günlüğü saklar, özeti gösterir.
Özellikler

Akıllı, yerel ve görünmez

Bir kez kurun; kancalar, MCP ve kurallar her ajana otomatik bağlanır.

Tek komutla kurulum

sam install ajanlarınızı algılar, kancaları + MCP’yi + kuralları yazar ve kendini test eder. sam uninstall eklediği her şeyi kaldırır.

Paylaşılan canlı bellek

~/.sam/sam.db aynı ortamdaki tüm ajanlar arasında canlı paylaşılır.

Hibrit erişim

BM25 + trigram + TR/EN eş anlam genişletme (+ isteğe bağlı embedding) → RRF; önem ve yenilik ağırlığı.

Kararlar güncel kalır

“X yerine Y” ve “konu: değer” kalıplarıyla eski kararların yerine yenisi geçer; tarih damgalı, en yeni önce.

Çıktı kasası

1.800 testlik bir günlük 20.652 tokendan 89 tokena iner; tam metin sam-memory out <id> --grep ile.

Güvenlik ve köken

Her anının yazarı kayıtlı; ajan sizin sabitlediğiniz değeri ezemez; gizli bilgiler maskelenir; ekip dosyası insan onayı ister.

Ekip belleği git’te

Proje bilgisini commit edilen .sam/memory.md ile paylaşın; sam trust içeriği sabitler.

Türkçe ve İngilizce

“Bundan sonra…”, “unutma…” gibi Türkçe yönergeleri de yakalar; TR↔EN sorgular eşleşir.

Windows dahil

Kanca komutları her ana makine kabuğu için üretilir; CI’da Windows × Node 22.16/24.

Ölçümler

Aynı hatırlamayla çok daha az token

Depodaki npm run bench* betikleriyle yeniden üretilebilir.

~94%tam bellek dökümüne göre daha az token, aynı 20/20 hatırlamayla
93.1%bellek gerektiren kodlama görevlerinde başarı (belleksiz: %16,7)
4MCP aracı, ~380–420 şema tokenı
≈86 msistem başına medyan kanca gecikmesi (Node başlangıcı dahil)

Token ölçümü sentetik bir proje külliyatında yapıldı ve yol göstericidir; kodlama değerlendirmesi 34 görev, 1.899 notlanmış çağrı. Yöntem ve uyarılar README ve bench/ klasöründe.

Nasıl çalışır

Kancalar yakalar, motor seçer, ajan yalnızca gerekeni görür

Yakala

Yönergeler, düzenlemeler, komutlar ve sonuçları, hata→çözüm çiftleri ve satır içi ⟦mem⟧ işaretleri — model çağrısı olmadan.

Sakla

Türlü anılar, köken, yakın kopya birleştirme, eski kararın yerine geçme ve gizli bilgi maskeleme.

Getir

Hibrit arama + ilgililik ve projeye özgüllük kapıları; alakasız istemlerde neredeyse sessiz.

Enjekte et

Bütçeli kart, kanıta dayalı hatırlatma ve defter. Gerisi tek bir mem_search uzaklıkta.

Kurulum

İki komut. Hepsi bu.

Sunucu yok, API anahtarı yok, Python yok, Docker yok.

npm i -g super-agent-memory
# ajanlarınızı algılar; kancaları, MCP’yi ve kuralları bağlar
sam install

Seçerek kurmak için sam install claude codex …, hepsi için --all, önizleme için --dry-run.

Kaldırmak için sam uninstall: eklenen her şeyi, yedekler ve yeniden boşalan dosyalar dahil kaldırır.

Kimler için?

Birden çok ajanla, uzun soluklu projelerde çalışanlar

Ajanlar arasında gidip gelenler

Sabah Claude Code, öğleden sonra Codex: kararlar ve kurallar ikisinde de aynı.

Token bütçesine dikkat edenler

Bağlamı şişirmeden hatırlama: alakasız istemlerde neredeyse sıfır ek token.

Ekipler

Proje bilgisini git’te paylaşın; değişiklikler insan onayı olmadan içeri alınmaz.

SSS

Sık sorulan sorular

Verilerim nereye gidiyor?
Hiçbir yere. Her şey bilgisayarınızdaki tek bir SQLite dosyasında (~/.sam/sam.db). Sunucu ya da bulut yok.
Embedding modeli ya da API anahtarı gerekiyor mu?
Hayır. Tüm ölçümler embedding olmadan elde edildi; embedding isteğe bağlıdır.
WSL, konteyner ya da SSH’ta nasıl kullanılır?
Her ortam için bir yerel SAM_HOME kullanın; ortamlar arası taşımak için sam export --jsonl / sam import --trusted.
Codex kancaları neden çalışmıyor?
Codex kullanıcı kancalarını ancak /hooks ile bir kez onayladıktan sonra çalıştırır.
Kaldırırsam dosyalarım bozulur mu?
Hayır. Düzenlenen her dosyanın bir kerelik .sam-bak yedeği alınır; sam uninstall yalnızca eklediklerini kaldırır.

Ajanlarınıza bir hafıza verin. Bütçenize değil.

İki komutla kurun; bir sonraki oturumda her ajan nerede kaldığınızı bilsin.

Şimdi kurKaynak kodu gör