Engram

Engram es un único binario en Go con SQLite + FTS5 para búsqueda de texto completo, expuesto por CLI, API HTTP, servidor MCP y una TUI. Los datos viven en ~/.engram/engram.db (o donde apunte ENGRAM_DATA_DIR).

MCP es solo stdio

El transporte MCP de Engram es solo stdio: no existe un endpoint de red. Para la mayoría de los agentes (Claude Code, Gemini CLI, Codex, VS Code, Cursor, Windsurf) nunca corrés engram serve ni engram mcp a mano — el agente lanza engram mcp como subproceso stdio en cada sesión. engram serve (puerto 7437, atado a 127.0.0.1) solo hace falta para el plugin de OpenCode y la extensión de Pi.

Guardar y buscar

El agente decide qué vale la pena guardar y llama a mem_save con un resumen estructurado. mem_search busca por texto completo; con topic_key, mem_save se vuelve un upsert que actualiza la misma observación en vez de crear una nueva — ideal para decisiones que evolucionan con el tiempo.

Por sesión

Al terminar una sesión, el agente guarda un resumen con mem_session_summary; la próxima sesión recibe ese contexto automáticamente, sin que nadie lo pida.

Diagnóstico

engram doctor es de solo lectura: detecta problemas pero no repara nada por default. engram doctor repair es un comando aparte, angosto y explícito.