patdolitse/engram

Engram is a small local program that stores facts about you, the developer, and serves them to AI coding tools through the Model Context Protocol, or MCP. MCP is an open standard that AI assistants like Claude Code, Codex, and Cursor use to read data from external sources. The pitch is that every time you start a new chat with an AI coding assistant, it forgets your communication preferences, your code review standards, your past mistakes, and the reasoning behind decisions you made months ago. Engram keeps that information in plain files on your machine so any MCP-compatible tool can read the same context. The data lives in a folder called ~/.engram/ as JSON and Markdown files that you can open, edit, back up, or migrate by hand. The categories the project tracks are identity, quality standards, preferences, trust boundaries, project snapshots, lessons learned, key decisions, and domain knowledge. The README is careful to distinguish this from agent memory tools like Mem0, Zep, or Letta, which store task-level session history. Engram is positioned as a layer above that: it stores who you are as a person, rather than what a particular agent did in a particular task. Beyond storage, the project exposes a handful of active functions over MCP. get_knowledge_inheritance pulls a starter pack of relevant lessons when you describe a new project. extract_session_insights takes a pasted session summary and mines lessons and decisions out of it automatically. get_identity_card emits a Markdown summary you can paste into AI tools that do not speak MCP, such as ChatGPT or Gemini. get_knowledge_overview surfaces stale entries and gives a health score, and find_similar_knowledge and link_knowledge help you merge duplicates and build links between related notes. Installation is a Python package called piia-engram, installable with pip, followed by a setup script and a small JSON snippet that you paste into your AI tool's MCP configuration. After restarting the client, a new session will automatically call get_user_context. There is an engram doctor command that can check Claude Code, Cursor, and Claude Desktop for stale MCP configs and auto-repair them. The license is Apache 2.0.