🤖 Agentlar için - makine okunabilir

Sen bir kodlama agentısın.
Bu da kalıcı belleğin.

Engram sana 11 MCP aracıyla kalıcı bellek verir. Öğrendiklerini kaydet, doğru bağlamı yükle, repolar arasında bilgi taşı, kullanılan bilgiyi raporla ve oturum sonunda öğrenme döngüsünü kapat.

Hızlı Kurulum

# 1. API anahtarıyla terminalde bunu bir kez çalıştır
npx -y engram-tools@latest --setup engram_...

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

# 3. Bunları terminal komutu değil, agent talimatı olarak yaz
Proje, repo, rol, pazar, teknoloji yığını ve görev bilgisiyle engram_start çağır.
Yaklaşım seçmeden önce mutlaka engram_recall çağır; başka repo’da çözülmüş olabilir diyorsan engram_cross_pollinate kullan.
Anlamlı aşamalarda, görev değiştirirken, birkaç memory kullanıldıktan sonra veya işi devretmeden önce engram_reflect kullan.

Aracın için kurulum

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}

Agent erişimi

Agent Engram satın alabilir mi?

Evet, e-posta ve ödeme adımlarını yönetebilen bir agent aynı checkout akışından geçebilir, workspace oluşturur ve API anahtarını kullanır. Değilse bir insan owner kayıt olur, takım arkadaşlarını davet eder ve her agent’a ayrı üye anahtarı verir.

Fiyatlandırmayı aç İnsan kurulum akışı

// Her aracı ne zaman kullanmalı

engram_start → Her yeni oturumdaki ilk çağrı. Kurulum bilgisini ve işe uygun bağlamı birlikte yükler.

engram_smarter → Görev değiştirirken göreve özel bellekleri ve rehberleri yükler.

engram_cross_pollinate → Benzer işi başka repo çözmüş olabilir; yeniden kurmadan önce oradaki dersleri getirir.

engram_store → Kalıcı değeri olan bir şey keşfettiğinde kaydet. Takımdaki sonraki agent bunu tekrar öğrenmek zorunda kalmasın.

engram_recall → Her önemli karar, plan veya bilinmeyen hata öncesi çağır. Sadece takılınca değil, yaklaşım seçmeden önce kullan.

engram_report_outcome → Hatırlanan bilgi yardımcı olduysa ya da olmadıysa bildir. Sıralama böyle iyileşir.

engram_reflect → Anlamlı aşamalar, görev değişimleri, birkaç kullanılan memory veya devir öncesi için kontrol noktası oluşturur.

engram_get_context → engram_get_context sadece ileri seviye/debug 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/admin kullanımı: memory sayıları, aktivasyon, kullanım ve benchmark kanıtını gösterir. Günlük kodlama akışının parçası değildir.

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

Frontend'deki bir Cursor agent'ı API'nin snake_case beklediğini keşfeder. Backend'deki Claude Code agent'ı 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ın." Takım standardını otomatik olarak uyguluyorsun.

Engram ile ilk oturum

İlk kez bağlandığında agent tarafında ne olacağını netleştiriyoruz.

İnsan kullanıcın Engram’ı MCP ayarlarına ekler.

Başlangıç ve bellek araçlarını görürsün: engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context ve engram_setup.

Önce proje, repo, rol, pazar, teknoloji yığını ve görev bilgisiyle engram_start çağır.

Engram en ilgili ekip bilgisini ve uygun rehberleri tek çağrıda yükler.

Normal çalış, ama yaklaşım seçmeden önce mutlaka engram_recall çağır. Benzer işi başka repo çözmüş olabilir; o durumda engram_cross_pollinate çağır.

engram_reflect bir zamanlayıcı değildir; anlamlı bir aşama bitince, görev değiştirirken, birkaç memory kullanıldıktan sonra veya işi devretmeden önce kontrol noktası oluşturur.

API referansı

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

engram_start

Her session’ı tek çağrıda başlatır. Setup guidance, ilgili memory’ler ve skill rehberlerini yükler.

{
  "agent_tool": "codex",
  "project": "HouseCompass",
  "repo": "housecompass.uk",
  "role": "frontend product engineer",
  "market": "UK property",
  "task": "build listing detail page",
  "stack": ["Next.js", "TypeScript", "PostgreSQL"]
}

engram_smarter

Task değiştirirken task’a özel memory ve skill rehberlerini yükler.

{
  "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

Workspace içindeki diğer repolardan tekrar kullanılabilir dersleri bulur.

{
  "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

Öğrenilmiş convention, pattern, gotcha veya solution kaydeder.

{
  "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

Semantic query ile ilgili memory’leri repo, type veya tag filtreleriyle getirir.

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

engram_report_outcome

Hatırlanan memory’nin başarıya mı hataya mı yol açtığını raporlar. Gelecek ranking’i iyileştirir.

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

engram_reflect

Session sonunda loop’u kapatır: kullanılan memory’leri raporlar, kalıcı öğrenimleri kaydeder.

{
  "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

Bir repo için ilgili memory’leri tek çağrıda getirir. Repo değiştirirken kullan.

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

engram_skill

Migration, review, deploy ve debugging gibi kompleks işler için tam skill rehberi yükler.

{
  "skill": "security-audit"
}

engram_proof

Ürün kanıtlarını gösterir: bellek sayısı, öğrenme döngüsü, kullanım, aktivasyon ve benchmark özeti.

engram_proof()

engram_setup

Workspace bilgisi, mevcut tool’lar ve best-practice guidance döndürür.

{
  "agent_tool": "claude-code"
}

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

Bozulan veya şaşırtan şeyler

"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ürleri, hız sınırları ve fiyatlandırma içeren JSON döndürür; programatik tüketim için tasarlanmıştır.

Sen bir kodlama agentısın.
Bu da kalıcı belleğin.

Aracın için kurulum

Agent Engram satın alabilir mi?

// Her aracı ne zaman kullanmalı

Oturumlar Arası Öğrenme

Takım Bilgi Transferi

Kural Uygulaması

Engram ile ilk oturum

API referansı

Bellek Türleri

Engram’ı birlikte geliştirelim

Neyi geliştirelim?

Sen bir kodlama agentısın.Bu da kalıcı belleğin.

Aracın için kurulum

Agent Engram satın alabilir mi?

// Her aracı ne zaman kullanmalı

Oturumlar Arası Öğrenme

Takım Bilgi Transferi

Kural Uygulaması

Engram ile ilk oturum

API referansı

Bellek Türleri

Engram’ı birlikte geliştirelim

Neyi geliştirelim?

Sen bir kodlama agentısın.
Bu da kalıcı belleğin.