🤖 Ajanlar için - makine okunabilir

Sen bir kodlama ajanısın.
Bu da bellek API’n.

Engram sana 17 MCP aracıyla kalıcı bellek sağlar. Öğrendiklerini kaydet, doğru bağlamı yükle, repolar arasında bilgi taşı, kullanım verilerini göster ve değerlendirmeyle öğrenme döngüsünü tamamla.

Hızlı Kurulum
# 1. Ücretsiz dene; e-posta veya API anahtarı gerekmez
npx -y engram-tools@latest --setup

# 2. Claude, Codex, Cursor, Gemini veya Antigravity, Windsurf veya VS Code’u yeniden başlat

# 3. Bunları terminal komutu değil, ajan talimatı olarak yaz
Proje, repo, rol, pazar, teknoloji yığını ve görev bilgisiyle engram_start çağır.
Yaklaşım seçmeden önce engram_recall çağır. Benzer bir işi başka repo çözmüş olabilir; o durumda engram_cross_pollinate kullan.
Bağlam sıkıştırıldıysa, oturum özetlendiyse, kaldığın yer belirsizse veya oturuma yeniden döndüysen, devam etmeden önce engram_rehydrate çağır. Önemli aşamalardan sonra, görev değiştiğinde, birkaç bellek kaydı kullandıktan sonra veya işi devretmeden önce engram_reflect ile kontrol noktası oluştur.

Aracın için kurulum

// ~/.claude/mcp.json
{
"mcpServers": {
"engram": {
"command": "npx",
"args": ["-y", "engram-tools@latest", "mcp"],
"env": {
"ENGRAM_API_URL": "https://api.engram.tools"
}
}
}
}
Ajan erişimi

Ajan e-postasız deneyebilir mi?

npm paketi ayrı bir ücretsiz deneme alanını otomatik oluşturur; e-posta veya API anahtarı gerekmez. Glama gibi dizinler üzerinden yapılan uzak HTTP bağlantılarında ise OAuth ve e-posta doğrulaması gerekir. Daha sonra connect komutuyla e-postanı doğrulayıp denemeyi kendi hesabına bağlayabilirsin; bellek kayıtların aynı çalışma alanında kalır. Ücretli yükseltmeler için bir insanın onayı gerekir.

Sonraki oturumunuz da hatırlasın

Gerçek bir proje kararını iki oturum arasında deneyin.

1

Kurulum izniyle npx -y engram-tools@latest --setup çalıştırıp ücretsiz npm denemesini başlatın. E-posta veya API anahtarı gerekmez. Mevcut çalışma alanınızı koruyun.

2

Kodlama istemcisini yeniden bağlayın. Gerçek repo ve görevinizle engram_start çağırın.

3

Çalışırken doğrulanmış bir proje kararını ve gerekçesini engram_store ile kaydedin. Gizli bilgi kaydetmeyin.

4

Aynı repoda yeni oturum açın. Ajanın engram_recall ile kararı ve gerekçesini bulmasını isteyin.

5

Kaynak kaydı güncel projeyle doğrulayın. Yararlı olup olmadığını engram_report_outcome ile bildirin.

6

Deneme alanını korumak istediğinizde npx -y engram-tools@latest connect çalıştırıp e-postayı doğrulayın. Kayıtlar aynı çalışma alanında kalır.

İlk oturum

Bu repodaki gerçek görevim için engram_start çağır. Çalıştıktan sonra doğrulanmış bir kararı ve gerekçesini engram_store ile kaydet. Mevcut çalışma alanını koru; gizli bilgi veya uydurma örnek kaydetme.

Sonraki oturum

Önceki oturumdaki proje kararını ve gerekçesini engram_recall ile getir. Kaynak kaydı göster, güncel projeyle doğrula ve işe devam et. Yararlı olup olmadığını bildir.

// Her aracı ne zaman kullanmalı

engram_start → Her yeni oturumdaki ilk çağrı. Proje, repo, rol, pazar, teknoloji yığını ve mevcut görev bilgisiyle çağır. Kurulum bilgisini, özel belleği, herkese açık bilgileri ve uygun rehberleri tek çalışma haritasında toplar.
engram_rehydrate → Bağlam sıkıştırıldıysa, oturum özetlendiyse, oturuma yeniden döndüysen, kaldığın yer belirsizse veya konuşma geçmişi eksildiyse kullan. Son kontrol noktasını, kararları, açık işleri, dikkat noktalarını ve son öğrenilenleri geri getirir.
engram_smarter → Oturum içinde görev değiştiğinde veya önceki problemin etkisinde kaldığını hissettiğinde kullan. Yeni bir dosya, hata veya ürün alanına odaklanmak için daha hafif bir bağlam yenileme çağrısıdır.
engram_cross_pollinate → Benzer işi başka repo çözmüş olabilir: mobil Safari paneli, yerelleştirme, deploy, kimlik doğrulama, faturalandırma, veri aktarımı, scraper veya kalite kontrolü. Aynı çözümü yeniden kurmadan önce diğer repolarda öğrenilen bilgileri getir.
engram_store → Kalıcı değeri olan bir şey keşfettiğinde kaydet: repo kuralı, canlı sistemde dikkat edilecek bir ayrıntı, yeniden kullanılacak bir çözüm, mimari karar veya test/deploy alışkanlığı. Tek seferlik log gürültüsü, parola ve anahtar gibi gizli bilgiler ya da müşteri verisi kaydetme.
engram_recall → Planlama, mimari, bilmediğin hatalar, kimlik doğrulama, faturalandırma, deploy, veri veya UX kararlarından önce çağır. Önceden yapılmış bir işi tekrarlama ihtimali olduğunda belleğe başvur. Sadece takılınca değil, yaklaşım seçmeden önce kullan.
engram_report_outcome → Bellekten gelen bilginin işe yarayıp yaramadığını, güncelliğini yitirip yitirmediğini veya yanlış bağlamdan gelip gelmediğini bildir. Ajanların bu geri bildirimi, sonraki sonuçların sıralamasını iyileştirir.
engram_reflect → Anlamlı bir aşama bitince, görev değiştirirken, birkaç bellek kullandıktan sonra veya işi devretmeden önce kontrol noktası oluştur. Bu bir zamanlayıcı değildir; bağlam sıkıştırıldıktan veya iş devredildikten sonra devam etmeyi kolaylaştıran bir defter notudur.
engram_get_context → engram_get_context sadece ileri seviye hata ayıklama durumlarında, odaklı repo bilgi dökümü gerektiğinde kullanılır. Normal oturumlarda engram_start veya engram_smarter kullanılır.
engram_proof → Ürün ve yönetim işleri için: bellek sayısını, aktivasyonu, kullanımı ve benchmark için ölçüm verilerini gösterir. Günlük kodlama akışının parçası değildir.
Ajan feedback protokolü

İnsan formu doldurma. Bellek döngüsünü eğit.

Bir bellek işe yaradıysa, bayatsa veya yanlış bağlama geldiyse bunu araçlarla bildir. Bu sinyal genel feedback mesajından daha değerli; çünkü sonraki sıralamayı doğrudan iyileştirir.

01Hatırlanan bir bilgiyi kullandıktan sonra engram_report_outcome çağır; işe yaradıysa true, yaramadıysa false gönder.
02Birden fazla bellek işi şekillendirdiyse engram_reflect ile milestone checkpoint oluştur.
03Başka repo aynı pattern’i çözmüş olabilir diyorsan planlamadan önce engram_cross_pollinate çağır.

Oturumlar Arası Öğrenme

Oturum 1'de zor bir hatayı düzeltiyorsun. Oturum 2'de aynı hata kalıbı farklı bir dosyada ortaya çıkıyor. Düzeltmeyi anında hatırlıyorsun.

Takım Bilgi Transferi

Önyüzdeki bir Cursor ajanı API'nin snake_case beklediğini keşfeder. Arka uçtaki Claude Code ajanı bunu kimse söylemeden öğrenir.

Kural Uygulaması

Kod yazmadan önce proje kurallarını hatırlıyorsun. "Doğrulama için Joi değil Zod kullan." Takım standardını otomatik olarak uyguluyorsun.

Bellek, güncellik ve geri bildirim

Araçların nasıl davrandığını açıklayan rehber. Parametre tabloları MCP şemasından üretilir. Yanıt örnekleri, hassas bilgilerden arındırılmış HTTP yanıtı parçalarıdır. MCP, JSON, Markdown veya kısa onayları text/format üzerinden iletir; ayrıştırmadan önce format alanını kontrol edin.

İşe uygun başlangıç aracını seçin

Bir repoda çalışmaya başlama

engram_start

Çalışma alanı özeti ve ilgili bilgiler

Belirli bir soruyu yanıtlama

engram_recall

O soruya göre sıralanmış kayıtlar

Bağlam dururken görev değiştirme

engram_smarter

Yeni göreve yönelik özet

Bağlam kaybından sonra devam etme

engram_rehydrate

Güvenli günlük kurtarma ve güncel bellekle devam etme

Bir aşamanın kontrol noktasını kaydetme

engram_reflect

Kontrol noktası; oturum açık kalır

npm istemcisi, e-posta veya API anahtarı olmadan ayrı bir ücretsiz deneme başlatabilir. Uzaktan OAuth bağlantıları e-posta doğrulaması ister. Kimlik bilgisi uydurmayın. repo, yetkili olduğunuz çalışma alanının içindeki bir filtredir; başka çalışma alanına erişim vermez.

Repo çalışmasına başlarken engram_start, tek bir soru için engram_recall, görev değiştirirken engram_smarter, bağlam sıkıştırılması veya kesinti sonrasında engram_rehydrate kullanın. Smarter yeni görev için kalıcı bellekte arama yapar; önceki günlüğü yeniden kurmaz. İki araç da oturum olayı kaydedebilir. Rehydrate kapanmış oturumları ve ekip arkadaşlarının geçmişini okuyabilir; onları yeniden açamaz veya değiştiremez. engram_reflect oturumu açık bırakır; engram_close_session açık bir bitirme işlemidir.

focused varsayılanları start=8, recall=5, smarter=5, cross_pollinate=5 kayıttır. deep için sırasıyla 16, 12, 12 ve 12'dir. Açıkça verilen limit, aracın üst sınırı içinde varsayılanı değiştirir. include_skills true veya false olarak verilmediyse uygun rehberler görevdeki anahtar sözcüklerden seçilir.

Rehydrate için günlük ayrıntısı ayrı yönetilir: depth=brief en fazla 12 olay ve 2 özet, standard 30 olay ve 4 özet, full 60 olay ve 8 özet döndürür. limit veya arama derinliği değerleri olan focused/deep kabul edilmez.

Recall count=0 döndürürse eşleşen kayıt bulunmadığını söyleyin. repo ve sorguyu kontrol edin; gerekirse sorguyu değiştirin veya depth=deep kullanın. Daha fazla sonuç, ilgisiz bilgiyi ilgili yapmaz. Başka bir repoda taşınabilir bir ders bulunması bekleniyorsa cross_pollinate kullanın. get_context, kategorileri bilinçli incelemek içindir; her boş aramadan sonraki otomatik adım değildir.

Kuralları değişebilen olgulardan ayırın

Her bellek kaydında bağımsız güncellenebilen tek bir bilgi tutmayı tercih edin. İzin kuralı ile canlıya çıkış durumu ayrı ID'lere sahip olmalıdır. Tek kayıt için type, content ve isteğe bağlı claim kullanın; ya da her biri type, content ve claim içeren 1–32 bağımsız birimi claims ile gönderin. İki biçimi karıştırmayın. Türlendirilmemiş eski kayıtlar legacy_unassessed olarak kalır; üst veri eklemek, kaydın yalnızca tek bilgi içerdiğini kanıtlamaz.

type, CONVENTION veya SOLUTION gibi aramada kullanılan kategoridir; claim.kind bilginin niteliğini belirtir: rule, decision, state, lesson veya reference. stage yalnızca state için kullanılır: proposed, implemented, tested veya deployed. State, saat dilimi içeren ISO biçiminde observed_at ister; zaman sunucu saatinden bir dakikadan fazla ileride olamaz. UTC ve açık saat dilimi farkları kabul edilir; çağrıyı yapan sistemin saatini doğru tutun. tested/deployed için evidence da gerekir. Kanıtı ajan sağlar; Engram bağımsız olarak doğrulamaz. İsteğe bağlı review_after, observed_at öncesinde olamaz; gözden geçirme tarihidir, otomatik son kullanma tarihi veya bir kuralı kaldırma izni değildir.

kind=rule etiketi ajana insan yetkisi vermez ve mevcut talimatların önüne geçmez. supersedes_memory_ids ve change_reason yalnızca doğrulanmış bir değiştirme için kullanılmalıdır. Eski kaydı bölmek için memory_id ve content_sha256 içeren split_from kullanılır; varsayılan önizlemedir. Yalnızca dry_run=false ve dönen split:<id>:<plan_hash> onayıyla uygulayın. Tarihsel parçalar tarihsel kalır; bir kaydın başarı oylarını ilgisiz yeni bilgilere taşımayın.

Örnek: yer tutucuları gerçekten dönen değerlerle değiştirin.

{
  "claims": [
    {
      "type": "CONVENTION",
      "content": "Deployment requires explicit owner approval.",
      "claim": {
        "kind": "rule"
      }
    },
    {
      "type": "SOLUTION",
      "content": "The OAuth callback fix passed the isolated test suite.",
      "claim": {
        "kind": "state",
        "stage": "tested",
        "observed_at": "2026-11-15T09:00:00Z",
        "evidence": "Commit abc1234; isolated OAuth regression receipt"
      }
    }
  ]
}
Eski bir karma kaydı, geçerli kuralı kaybetmeden inceleyin

Bir kayıt geçerli izin kuralını ve eskimiş yayın durumunu birleştiriyorsa yalnızca durumu gizlemek için tüm kaydı geri çekmeyin. Önce bağımsız bilgilerin her birini inceleyin. Önerilen claims içinde kuralı etkin tutun; yalnızca eskiyen parçayı tarihsel işaretleyin. Bölmeyi kaydı oluşturan kişi veya insan çalışma alanı sahibi yapabilir. Kaynak özel, etkin ve henüz tekil claim olarak tanımlanmamış olmalıdır.

Önizleme için claims ve split_from birlikte gönderilir. content_sha256 değerini kısaltılmış görünümden veya yeniden anlatımdan değil, saklanan kaynak metnin aynısından hesaplayın. Önizleme bellek kaydı yazmaz. Uygulamadan önce dönen claims, active_claims ve historical_claims alanlarını inceleyin. Aşağıdaki örnek MCP SDK sözde kodudur: source gerçek kaynak kayıt, claims ise incelediğiniz birim dizisidir; historical:true yalnızca eskiyen parçalarda kullanılır.

Değişmeyen kaynak ve birim planını dry_run=false ile, önizlemenin confirmation değerini aynen kullanarak tekrar gönderin. Onay değerini kendiniz üretmeyin. Kaynak veya plan değişirse yeni önizleme gerekir. Özgün kayıt geçmişte korunur; yeni birimler eski oyları almadan ayrı ID'ler edinir. Önizleme, önerilen yazımın biçimini doğrular; yaptığınız incelemenin doğruluğunu değil.

Örnek: yer tutucuları gerçekten dönen değerlerle değiştirin.

const plan = {
  split_from: {
    memory_id: source.id,
    content_sha256: sha256(source.content) // SHA-256 hex of exact text
  },
  claims // reviewed independent units; obsolete pieces use historical: true
};
const result = await client.callTool({ name: "engram_store", arguments: plan });
if (result.isError) throw new Error("Split preview failed");
if (result.structuredContent?.format !== "json") throw new Error("Expected JSON preview");
const preview = JSON.parse(result.structuredContent.text);
// Review preview.claims, active_claims and historical_claims before applying.
await client.callTool({
  name: "engram_store",
  arguments: { ...plan, dry_run: false, confirmation: preview.confirmation }
});
Yararlı olmak, doğrulanmış ve güncel olmakla aynı şey değildir

success=true, bilginin göreve yardımcı olduğunu belirtir. Bugün doğru olduğunu, canlıya çıkmış olduğunu veya eski karma kayıttaki her cümlenin doğru olduğunu kanıtlamaz. trust=validated ve confidence, bildirilen yararlılığı gösteren uyumluluk etiketleridir; bağımsız doğrulama değildir. claim.stage, observed_at, evidence ve last_outdated_report_at alanlarını okuyun; kritik bilgileri güncel kod veya çalışan sistemden doğrulayın.

İlk alaka değerlendirmesi relevant, irrelevant veya uncertain olabilir. Gerçek kullanımın yararı helpful, unhelpful, not_used veya not_evaluated ile bildirilir. Yalnızca helpful/unhelpful bir sonuç oyu oluşturup confidence değerini etkiler. Sonuç ilgisiz ve kullanılmamışsa irrelevant ile not_used birlikte bildirilir; başarısız kullanım oyu oluşmaz. Geri bildirim yoksa kayıt değerlendirilmemiştir. Alaka notları ile kullanım kanıtları ayrı tutulur.

engram_reflect.feedback veya POST /api/v1/feedback üzerinden useful/noisy/stale/missing_context/too_long bildirmek Engram ürününü değerlendirir. Tek bir bellek kaydının kullanım sonucundan ayrıdır ve o kaydın confidence değerini değiştirmez.

Geri bildirimi doğru sorguya bağlayın ve tekrarları güvenle yönetin

retrieval_id, kaydedilmiş sonuç listesinin gösterimini; session_id ise günlüğü tanımlar. Aynı kayıt paralel sorgularda geliyorsa her sonuç listesiyle retrieval_id değerini birlikte tutun. retrieval_id null ise o yanıt için kesin sorgu bağlantısı yoktur. Makbuz, kayıt ve çağrıyı yapan kişi hâlâ erişilebilir durumdaysa eski veya kapanmış kaynaklar da açık bağlantılı geri bildirim alabilir; kaynak oturumu yeniden açmayın.

Tek bir gerçek kullanım için engram_report_outcome'a memory_id, success ve retrieval_id verin. En fazla 20 benzersiz sorgu/kayıt çifti için outcomes kullanın. Aynı öğeleri sonraki start, recall, smarter, store, reflect, cross_pollinate, get_context, skill veya report_outcome çağrısına pending_feedback olarak da ekleyebilirsiniz. Bunun için outcome:write gerekir; ek çağrı kotası tüketilmez. Değerlendiremediğiniz sonuçlara yargı uydurmak yerine onları dışarıda bırakın.

Kesin bağlantılı bir bildirimi tekrarlarken aynı retrieval_id, memory_id ve kullanım alanlarını gönderin. Engram yanıtta duplicate=true döndürür ve yeni oy eklemez. duplicate bir girdi değildir; retry bayrağı yoktur. Bu tekrar 409 hatası değildir; yalnızca kaydedilmiş kullanım oyunu değiştirmek 409 döndürür. retrieval_id içermeyen eski biçim ise son 24 saatte aynı üye ve çalışma alanı için bu kaydı içeren en yeni gösterimi seçer. session_id verilirse arama o günlüğe daralır. Eski biçimde tekrar yeni oy ekleyebilir; çıkarımsal bağlantıyı kesin sanmayın. Gerçekten yeni bir kullanım, yeni bir gösterime bağlanmalıdır.

Geri bildirim grubu asıl işlemden önce kaydedilir. Asıl işlem başarısız olsa bile feedback_receipt alanını kontrol edin; geri bildirim tamamlanmış olabilir. Uzaktan MCP ve npm istemcisi hata durumunda bu makbuzu korur. Kaydı tamamlanmış geri bildirim içeren hata otomatik tekrarlanmaz; asıl işlem yine de tekrara dayanıklı olmayabilir. reflect.used_memories içinde en fazla 20 öğenin her birine retrieval_id vererek kesin bağlantılı tek bir atomik grup oluşturun; eski biçimdeki öğeleri ayrı reflect çağrısında tutun. Sonraki öğrenim veya kontrol noktası başarısız olabilir; feedback_receipt kabul edilmiş oyları gösterir.

Örnek: yer tutucuları gerçekten dönen değerlerle değiştirin.

{
  "repo": "example",
  "query": "Which deployment rule applies?",
  "pending_feedback": [
    {
      "retrieval_id": "<id from the previous result list>",
      "memory_id": "<memory in that list>",
      "relevance": "irrelevant",
      "usefulness": "not_used"
    }
  ]
}

Önerilen: sorguya bağlı kullanım sonuçları (engram_reflect parametreleri)

{
  "store": false,
  "summary": "Applied the recalled approval rule.",
  "used_memories": [
    {
      "retrieval_id": "<id from that result list>",
      "memory_id": "<memory in that list>",
      "success": true,
      "detail": "Checked owner approval before releasing."
    }
  ]
}

Uyumluluk için: ayrı bir eski biçim bildirimi (engram_reflect parametreleri)

{
  "store": false,
  "summary": "Reported a use without a retained query receipt.",
  "used_memories": [
    {
      "memory_id": "<accessible memory id>",
      "success": true,
      "detail": "This use has inferred attribution, not an exact query link."
    }
  ]
}
Geri çekme, kalıcı silme ve güvenli oturum kurtarma

engram_retract_memory özel bilgiyi geri alınabilir biçimde geri çeker; kaydı oluşturan kişi veya insan çalışma alanı sahibi kullanabilir. engram_restore_memory saklanmış, geri çekilmiş bir kayıt ister; kotayı ve doğrulanmış değiştirmeleri kontrol eder. Aynı metni kaydetmek veya rehydrate çağırmak kaydı sessizce geri getirmez. Kalıcı silinen kayıt geri yüklenemez.

OAuth token'ı, bağlı üye OWNER olsa bile kalıcı silmeyi önizleyemez veya çalıştıramaz. İki işlem de insan çalışma alanı sahibinin ayrı API kimlik bilgisi yolunu gerektirir. OAuth kısıtını aşmak için sahip anahtarı edinmeyin veya yerine koymayın. engram_delete_memory varsayılan olarak etkiyi önizler; yalnızca dry_run=false ve confirmation=delete:<exact memory_id> ile çalıştırın. Canlı kaydı, bilinen bağlantılı kopyaları ve etkilenen günlüklerin serbest metnini siler. Daha önce istemciye ulaşmış bağlam, bağımsız kayıtlar, bağlantısız yeniden anlatımlar, sağlayıcılar ve yedekler bu hedefli canlı silmenin kapsamı dışındadır.

Oturum keşfi, geri çekilen, süresi dolan veya silinen bilgiye bağlı görev metnini gizler. Günlük güvenle yeniden kurulamıyorsa güvenli güncel bellekten yararlanın veya engram_start(new_session=true) ile temiz günlük açın; gizlemeyi aşmaya çalışmayın. Saklanan kaynağı geri yüklemek, güvenli saklanmış geçmişini yeniden erişilebilir yapabilir.

API referansı

17 MCP aracı için eksiksiz dokümantasyon.

engram_start

Repo çalışmasını başlatın. Anlamlı bir oturumun başında kullanın; kaybolan bağlamı kurtarmak için rehydrate seçin. Çalışma alanı rehberi, oturum ID'si ve ilgili bilgiler döner.

{
"agent_tool": "codex",
"project": "English.cash",
"repo": "english.cash",
"role": "full-stack product engineer",
"market": "English learning",
"task": "fix guest practice so it uses the same API path as paid practice",
"stack": ["Next.js", "TypeScript", "PostgreSQL", "LLM router"]
}
engram_rehydrate

Kesinti veya bağlam kaybından sonra devam edin. Sıkıştırma, özet veya eksik geçmişten sonra devam etmeden önce kullanın. Güvenle okunabilen kontrol noktaları, kararlar ve açık işler döner; kapanmış geçmiş yeniden açılmaz.

{
"agent_tool": "codex",
"project": "Engram",
"repo": "engram",
"task": "continue mobile Safari chat fix after context compaction",
"reason": "chat was compacted and only a short summary remains",
"depth": "standard"
}
engram_smarter

Görev değişince yeniden odaklanın. Aynı etkin oturumda başka bir işe geçerken kullanın; kayıp günlüğü geri getirmez. Yeni görev için bilgiler ve uygun rehberler döner.

{
"context": "Next.js 16 mobile Safari chat widget overflows when keyboard opens",
"repo": "engram",
"file": "web/src/components/ChatWidget.tsx",
"include_skills": true
}
engram_cross_pollinate

Diğer repolardaki dersleri aktarın. Başka bir projenin benzer sorunu çözmüş olması bekleniyorsa kullanın. Kaynak repo ve uygulanabilirlik bilgileriyle dersler döner; hedef repo kaynak aramasından dışlanır.

{
"target_repo": "skillbridge-monorepo",
"context": "Add team invite flow with owner/admin permissions and email delivery",
"source_repos": ["engram", "evimibul"],
"include_public": true,
"limit": 5
}
engram_store

Bağımsız sürdürülebilen bilgiyi kaydedin. Kalıcı bir ders doğrulandığında kullanın; bir kuralı geçici yayın durumuyla birleştirmeyin. Kaydedilen ID veya claims için ayrı ID'ler döner; bölme varsayılan olarak önizlenir.

{
"type": "SOLUTION",
"content": "Mobile Safari chat panels should not autofocus inputs. Size the fixed panel from visualViewport, use 16px input text, and assert bounds after typing.",
"tags": ["ios", "safari", "mobile", "chat-widget"],
"repo": "engram",
"agent_tool": "codex",
"context": {
"file": "web/src/components/ChatWidget.tsx",
"platform": "ios-safari"
}
}
engram_recall

Karardan önce belirli bilgiyi arayın. Tek bir soruya, önceki karara veya hataya odaklanın. Sıralı kayıtlar ve mümkünse retrieval_id döner. Eşleşme yoksa bunu açıkça belirtin.

{
"query": "Stripe checkout succeeded but workspace plan still free after webhook",
"repo": "engram",
"type": "SOLUTION",
"limit": 3
}
engram_report_outcome

Hatırlatılan bilginin yararını bildirin. Gerçekte kullandıktan sonra retrieval_id ile bağlayın; yalnızca ilgisiz olması başarısız kullanım değildir. Aynı kesin tekrar yeni oy eklemez; oyu değiştirmek 409 döndürür. Eski biçim son 24 saatten çıkarım yapar ve tekrar oy ekleyebilir.

{
"retrieval_id": "retrieval_id_from_that_recall",
"memory_id": "cmqstripeplan123",
"success": true,
"detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."
}
engram_reflect

Bir aşamanın kontrol noktasını kaydedin. Önemli iş, devir veya birkaç bilginin kullanımından sonra çağırın; zamanlayıcı değildir. Öğrenimler, sonuçlar ve kontrol noktası döner. store=false tüm yazımları kapatmaz; oturum açık kalır.

{
"repo": "engram",
"task": "Fix mobile Safari chat overflow and close behavior",
"summary": "Chat panel now sizes from visualViewport, avoids mobile autofocus, uses 16px input text, and close restores the launcher.",
"used_memories": [
{
"memory_id": "cmqioschat123",
"success": true,
"detail": "The iOS visualViewport gotcha pointed to the correct fix."
}
],
"learnings": [{
"type": "SOLUTION",
"content": "For mobile fixed panels, compute bounds from visualViewport and verify after focusing an input; CSS dvh alone may not catch layout viewport offset.",
"tags": ["mobile", "safari", "visualViewport"]
}]
}
engram_get_context

Repo belleğini kategorilere göre inceleyin. Odaklı denetim veya hata ayıklama için kullanın; her boş aramadan sonra gerekmez. İlgili kategorilerin dökümü döner; repo eşleşmezse kapsam genişleyebilir.

{
"repo": "engram",
"task": "Polish localized documentation without breaking rendered pages"
}
engram_skill

Adım adım uygulama rehberi alın. Tek proje olgusu yerine tekrarlanabilir bir iş akışı gerektiğinde kullanın. Rehber adımları veya mevcut adlar döner. Bilinmeyen rehber count=0 döndürür; bir şey kurulmaz veya çalıştırılmaz.

{
"skill": "security-audit"
}
engram_proof

Çalışma alanının kullanım kanıtlarını görün. Ürün veya yönetim incelemesinde kullanın; olağan kod akışında gerekli değildir. Bellek, kullanım, aktivasyon ve benchmark kanıtları döner.

engram_proof()
engram_setup

Kurulum ve çalışma alanı rehberini alın. Bağlantıyı öğrenmek için kullanın; günlük işe start ile başlayın. Çalışma alanı, araçlar ve sonraki yararlı adım gösterilir.

{
"agent_tool": "claude-code"
}
engram_list_sessions

Doğru oturum günlüğünü bulun. Birden fazla oturum eşleştiğinde tam ID'yi seçin; workspace ortak keşfi açar. Sayfalı üst veriler ve next_cursor döner; geri çekilmiş bilgiye bağlı görev metni gizlenir.

{ "repo": "engram", "scope": "mine", "limit": 20 }
engram_close_session

Belirli bir oturumu bitirin. İş bitimi veya devirde isteğe bağlıdır; oturum sahipliği ve session:write gerekir. Son kontrol noktası ve kapanış atomiktir. Tekrarda aynı makbuz gelir; bellekler ve salt okunur geçmiş korunur.

{ "session_id": "example-session", "summary": "Tests passed; deployment awaits approval." }
engram_retract_memory

Özel bilgiyi geri alınabilir biçimde geri çekin. Geçersiz yönlendirme için kaydı oluşturan kişi veya insan sahip memory:write ile kullanabilir. İçerik korunur; arama, bağımlı örüntüler ve ilgili günlük metni gizlenir. Tekrar etkisizdir.

{ "memory_id": "example-memory", "reason": "This advice needs revalidation." }
engram_restore_memory

Geri çekilmiş bilgiyi yeniden doğrulayıp etkinleştirin. Kaydı oluşturan kişi veya insan sahip kullanabilir; kota ve değiştirme kontrolleri uygulanır. Özgün ID ve içerik korunur. Etkin kayıt değişmez; silinen kayıt geri dönmez. Store bu işlemin yerine geçmez.

{ "memory_id": "example-memory" }
engram_delete_memory

Kalıcı silmenin etkisini inceleyip seçili kaydı silin. Önizleme dahil insan OWNER API kimlik bilgisi gerekir; OAuth yetmez. Çalıştırma için tam confirmation gerekir. Canlı kayıt, bilinen türevleri ve etkilenen günlük metni silinir; asgari makbuz kalır. Bağımsız kayıtlar, bağlantısız anlatımlar, istemcideki geçmiş, yedekler ve sağlayıcılar kapsam dışıdır.

{ "memory_id": "example-memory", "dry_run": true }

Bellek Türleri

CONVENTION

Kodlama standartları ve takım kuralları

"Always use Prisma migrations"

PATTERN

Tekrarlayan yaklaşımlar ve şablonlar

"API routes use cached() wrapper"

GOTCHA

Sorun çıkaran veya şaşırtan ayrıntılar

"Neon requires SSL in production"

SOLUTION

İşe yarayan düzeltmeler

"Fix: add pooler to connection string"

ARCHITECTURE

Sistem tasarım kararları

"Search uses Haversine + bbox"

DEPENDENCY

Kütüphane bilgileri ve sürümler

"Prisma 7 needs adapter pattern"

// Makine okunabilir uç nokta

GET https://engram.tools/api/v1/capabilities

Desteklenen araçları, bellek türlerini, istek sıklığı sınırlarını ve fiyatları JSON olarak döndürür. Yazılımlar tarafından kullanılmak üzere tasarlanmıştır.

Destek ve geri bildirim

Engram’ı birlikte geliştirelim

Kurulum kafa karıştırıyorsa, bir araç garip davranıyorsa veya plan limitleri uygun görünmüyorsa buradan yaz. Mesaj doğrudan bize gelir.

Geri bildirim

Neyi geliştirelim?

Hatalar, kafa karıştıran kurulum adımları, fiyat soruları ve ürün fikirleri doğrudan Engram ekibine gelir.

Geri bildirimin ekibimize ulaşmadan önce e-postanı doğrula. Bu işlem hesap açmaz.

10 karakter daha gerekli0/4000