engram_rememberLABSCO SUMMARY
Memory that reorganizes itself between sessions rather than waiting for you to curate it.
Consolidation is the part a flat file cannot imitate: it turns a pile of session notes into semantic knowledge, surfaces contradictions, and builds the entity graph on its own. engram_audit is the sharp edge of that — point it at your CLAUDE.md and it tells you which lines the vault now contradicts.
What it is
A local memory server: memories go into SQLite with vector embeddings and typed graph edges, and come back by meaning rather than by grep.
What you get
- engram_remember stores a memory and auto-extracts the entities and topics in it
- engram_recall and engram_ask — semantic retrieval, or a synthesized answer with confidence and sources
- engram_briefing opens a session with key facts, pending commitments and recent activity
- engram_consolidate distills episodes into semantic knowledge, discovers entities and finds contradictions
- engram_surface and engram_alerts push relevant memories and stale follow-ups without being asked
- engram_audit cross-references an external file such as CLAUDE.md against the vault and flags outdated claims
- engram_connect, engram_forget, engram_entities and engram_stats manage the graph itself
- engram_import_obsidian and engram_import_claude_code bring an existing vault or CLAUDE.md in
- A REST API on http://127.0.0.1:3800 for non-Node environments
Requirements
A Gemini API key — GEMINI_API_KEY is required, and embeddings are the only network calls the server makes. Install the engram-sdk package globally and run engram init, which registers the MCP server and writes the session hooks; engram doctor checks the vault, the key, embeddings and registration afterwards. Data stays in SQLite under ~/.engram.
Setup effort
One command plus a key — npm install -g engram-sdk, then supply credentials
USE CASES
Starting a session already knowing where you left off
Pull a structured briefing — key facts, open commitments, recent activity — instead of re-reading yesterday's thread.
Finding a decision you made months ago
Ask the question in your own words and get a synthesized answer with the source memories attached.
Catching instructions that have gone stale
Cross-reference your CLAUDE.md against the vault; claims the vault now contradicts come back flagged.
Saving context before a session gets cut off
Checkpoint the summary and let the server extract the durable memories out of it.
Moving existing notes in
Import an Obsidian vault with its wikilinks, tags and frontmatter, or pull in CLAUDE.md files and past sessions.
Letting the graph tidy itself
Run consolidation to distill episodes into semantic knowledge, discover entities and surface contradictions.
17 tools
Listed in project docs. Your client may show a different list.
engram_recallengram_askengram_briefingengram_consolidateengram_surfaceengram_alertsengram_auditengram_checkpointengram_connectengram_forgetengram_entitiesengram_statsengram_ingestengram_import_obsidianengram_import_claude_codeengram_powered_byBEFORE YOU INSTALL
What to know first
Tools you get
17 tools named in the project's documentation.
Requires
- npm on PATH
- GEMINI_API_KEY in your environment
INSTALLATION
Connect your client
Server setup
npm install -g engram-sdkMCP Clients
Claude Code, Cursor
npm install -g engram-sdk
engram init