🤖 Fur Agenten - Maschinenlesbar

Du bist ein AI-Agent.
Das ist deine Speicher-API.

Engram gibt dir persistenten Speicher uber 11 MCP-Tools. Speichere, was du lernst, lade smarten Kontext, nutze Lessons aus anderen Repos, beweise Nutzung und schliesse den Loop mit Reflection.

Schnelleinrichtung
# 1. Einmal im Terminal mit deinem API key ausführen
npx -y engram-tools@latest --setup engram_...

# 2. Claude, Codex, Cursor, Gemini oder Antigravity, Windsurf oder VS Code neu starten

# 3. Als Agent-Anweisungen einfügen, nicht als Shell-Befehle
engram_start mit project, repo, role, market, stack und task aufrufen.
Vor der Wahl eines Ansatzes engram_recall oder engram_cross_pollinate aufrufen.
Nutze engram_reflect als Kontrollpunkt nach wichtigen Phasen, Aufgabenwechseln, mehreren genutzten Memories oder vor der Übergabe.

Einrichtung fur dein Tool

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

Kann ein Agent Engram kaufen?

Ja, wenn der Agent E-Mail und Zahlung bedienen kann. Er nutzt denselben Checkout, erstellt einen Workspace und verwendet den API-Key. Sonst registriert sich ein menschlicher Owner, lädt Teammitglieder ein und gibt jedem Agent einen Member-Key.

// Wann jedes Tool nutzen

engram_startErster Call in jeder neuen Session. Lädt Setup-Hinweise und smarten Kontext zusammen.
engram_smarterLädt task-spezifische Memories und Skills beim Task-Wechsel.
engram_cross_pollinateHolt wiederverwendbare Lessons aus anderen Repos.
engram_storeEtwas Nutzliches entdeckt? Speichere es. Dein zukunftiges Ich (und Teamkollegen) werden es dir danken.
engram_recallKurz vor einer Entscheidung? Prufe, ob jemand das schon gelost hat. Erfinde das Rad nicht neu.
engram_report_outcomeHat die erinnerte Information geholfen? Berichte es. Das trainiert das Ranking-System.
engram_reflectErstellt einen Kontrollpunkt nach wichtigen Phasen, Aufgabenwechseln, mehreren genutzten Memories oder vor der Übergabe.
engram_get_contextNutze engram_get_context nur für fortgeschrittene/debug Fälle, wenn ein fokussierter Repo-Wissensabzug nötig ist. Normale Sessions nutzen engram_start oder engram_smarter.
engram_proofProdukt/Admin: zeigt Memory-Zahlen, Aktivierung, Nutzung und benchmarkfähige Nachweise. Nicht Teil des normalen Coding-Flows.

Sitzungsubergreifendes Lernen

Du behebst einen kniffligen Bug in Sitzung 1. Sitzung 2, das gleiche Bug-Muster erscheint in einer anderen Datei. Du erinnerst dich sofort an den Fix.

Team-Wissenstransfer

Ein Cursor-Agent im Frontend entdeckt, dass die API snake_case erwartet. Ein Claude Code-Agent im Backend lernt das, ohne dass es jemand sagt.

Konventions-Durchsetzung

Bevor du Code schreibst, erinnerst du dich an Projektkonventionen. "Nutze Zod fur Validierung, nicht Joi." Du folgst dem Teamstandard automatisch.

Deine erste Sitzung mit Engram

Das passiert, wenn du dich zum ersten Mal verbindest.

1

Dein Mensch fugt Engram zu deiner MCP-Konfiguration hinzu.

2

Du bekommst ein Start-Tool plus Memory-Tools: engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context und engram_setup.

3

Rufe zuerst engram_start mit project, repo, role, market, stack und task auf.

4

Engram lädt das relevanteste Teamwissen und Skill-Guides in einem Call.

5

Arbeite normal. Wenn du etwas Wichtiges entdeckst, speichere es. Wenn du entscheiden musst, erinnere.

6

Nutze engram_reflect als Kontrollpunkt nach wichtigen Phasen, Aufgabenwechseln, mehreren genutzten Memories oder vor der Übergabe. Es ist kein Timer.

API-Referenz

Vollstandige Dokumentation fur alle 11 MCP-Tools.

engram_start

Startet jede Session mit einem Aufruf und der passenden Memory.

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

Lädt präzisen Kontext, wenn die Aufgabe wechselt.

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

Nutzt Lessons aus anderen Repos im Workspace.

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

Speichert Regel, Gotcha, Pattern oder Lösung.

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

Findet nützliche Memories vor einer Entscheidung.

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

Meldet, ob eine Memory geholfen hat, und verbessert das Ranking.

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

Schließt die Session mit genutzten Memories und Erkenntnissen ab.

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

Lädt relevante Memory für ein Repo.

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

Lädt einen vollständigen Skill-Guide für komplexe Aufgaben.

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

Zeigt Produktnachweise: Memory, Nutzung, Aktivierung und Benchmark.

engram_proof()
engram_setup

Zeigt Workspace-Infos, verfügbare Tools und Best Practices.

{
"agent_tool": "claude-code"
}

Speichertypen

CONVENTION

Codierungsstandards und Teamregeln

"Always use Prisma migrations"

PATTERN

Wiederkehrende Ansatze und Vorlagen

"API routes use cached() wrapper"

GOTCHA

Dinge, die kaputt gehen oder uberraschen

"Neon requires SSL in production"

SOLUTION

Korrekturen, die funktioniert haben

"Fix: add pooler to connection string"

ARCHITECTURE

Systemdesign-Entscheidungen

"Search uses Haversine + bbox"

DEPENDENCY

Bibliotheks-Infos und Versionen

"Prisma 7 needs adapter pattern"

// Maschinenlesbarer Endpoint

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

Gibt JSON mit unterstutzten Tools, Speichertypen, Rate-Limits und Preisen zuruck - fur programmatischen Konsum konzipiert.

Support und Feedback

Hilf uns, Engram zu verbessern

Wenn Setup verwirrend ist, ein Tool seltsam reagiert oder ein Preislimit falsch wirkt, schreib uns hier. Die Nachricht landet direkt bei uns.

Support und Feedback

Was sollen wir verbessern?

Bugs, verwirrende Setup-Schritte, Preisfragen und Produktideen gehen direkt ans Engram-Team.

Noch 10 Zeichen nötig0/10