Engram
Engram is a local-first personal AI identity and memory layer exposed over MCP.
It lets MCP-compatible coding tools (Claude Code, Codex, Cursor, and other MCP
clients) start from the same user-approved understanding of who the user is, what
they've decided, and what they've learned — without a cloud account and without
hidden memory the user cannot inspect.
This skill tells you when to reach for Engram and which existing MCP tools
to use. It does not add new behavior; it routes to the Engram MCP server.
When to use this skill
Reach for Engram when the user's request implies continuity, recall, or durable
memory rather than a one-off task:
| Signal |
Example phrasing |
Where to start |
| Resume work |
"continue from last session", "pick up where we left off" |
get_resume_brief |
| Recall a decision |
"what did we decide", "why did we choose X" |
search_knowledge, get_relevant_knowledge |
| Save a lesson |
"remember this", "save a lesson", "note this gotcha" |
add_lesson |
| Save a decision |
"record this decision", "we chose X because Y" |
add_decision |
| Save a playbook |
"save this as a playbook", "remember these steps" |
add_playbook |
| Search prior knowledge |
"have we seen this before", "search what we know about X" |
search_knowledge |
| Identity / preferences |
"who am I to you", "what are my preferences" |
get_user_context, get_identity_card |
| Export identity/context |
"export my identity card", "give me my context" |
get_identity_card |
| End of session |
wrapping up, summarizing what changed |
wrap_up_session |
When the request is a normal coding task with no continuity or memory angle, do
not invoke Engram — just do the task.
How to use it (routing, not magic)
- Start of a continued session — call
get_resume_brief to recover the last
thread of work. For identity and preferences on a fresh project, call
get_user_context.
- During work — when the user asks what was decided or learned, call
search_knowledge (topic known) or get_relevant_knowledge (let Engram pick
what's relevant). Normal read/search tools provide session context; export
surfaces such as get_identity_card are owner-gated and can write local
files.
- Capturing durable knowledge — the user, not the AI, owns what becomes
permanent. When the user says to remember something, propose it and write it
with
add_lesson / add_decision / add_playbook. These are
user-approved writes, not automatic background memory.
- End of session — call
wrap_up_session to checkpoint context so the next
tool (or the next session) can resume.
Some MCP clients also run session hooks that capture context automatically; that
context lands in the user-visible daily log and the staging tier, where it is
inspectable and is not silently promoted to verified/trusted knowledge.
The full read/write tool map is in references/tools.md.
Privacy, ownership, and storage boundaries are in
references/privacy.md.
Honest boundaries
- Engram suggests; the user decides. AI-suggested knowledge is staged
for review, not silently promoted to verified/trusted memory; everything
written lands in the user's local store where it can be inspected.
- Storage is local JSON the user owns. There is no cloud account and no
vendor lock-in. Telemetry is off by default; if enabled it writes a local
log only, and any remote sending is a separate explicit opt-in.
- Knowledge moves through a staging → verified path so unreviewed entries do
not silently become trusted facts.
- Do not claim capabilities Engram does not have. Use only the tool names in
references/tools.md; do not invent tools.
MCP server
Engram runs as an MCP server via the piia-engram-mcp command. Configure your
MCP client to launch it (the Cursor plugin skeleton under .cursor-plugin/
shows one such wiring). By default the server exposes a Tier-1 core tool set;
the full set is available with ENGRAM_TOOLS=all.
1---2name: engram3description: Local-first personal AI identity and memory layer for MCP-compatible coding tools (Claude Code, Codex, Cursor, and others). Use this skill when the user wants to continue from a previous session ("continue from last session", "pick up where we left off"), recall a past decision ("what did we decide", "what was our reasoning"), persist something durable ("remember this", "save a lesson", "save a decision", "save a playbook"), search prior knowledge ("search what we know about X", "have we hit this before"), export their identity or context ("export my identity card", "give me my context"), or maintain local-first cross-tool identity and memory that the user owns and approves. Engram stores user-approved lessons, decisions, playbooks, and project context as local JSON; the AI suggests, the user decides what becomes permanent.4license: AGPL-3.0-or-later5metadata:6 source: https://skillmd.com/skills/patdolitse/engram7---89# Engram1011Engram is a local-first personal AI identity and memory layer exposed over MCP.12It lets MCP-compatible coding tools (Claude Code, Codex, Cursor, and other MCP13clients) start from the same user-approved understanding of who the user is, what14they've decided, and what they've learned — without a cloud account and without15hidden memory the user cannot inspect.1617This skill tells you **when** to reach for Engram and **which existing MCP tools**18to use. It does not add new behavior; it routes to the Engram MCP server.1920## When to use this skill2122Reach for Engram when the user's request implies continuity, recall, or durable23memory rather than a one-off task:2425| Signal | Example phrasing | Where to start |26| --- | --- | --- |27| Resume work | "continue from last session", "pick up where we left off" | `get_resume_brief` |28| Recall a decision | "what did we decide", "why did we choose X" | `search_knowledge`, `get_relevant_knowledge` |29| Save a lesson | "remember this", "save a lesson", "note this gotcha" | `add_lesson` |30| Save a decision | "record this decision", "we chose X because Y" | `add_decision` |31| Save a playbook | "save this as a playbook", "remember these steps" | `add_playbook` |32| Search prior knowledge | "have we seen this before", "search what we know about X" | `search_knowledge` |33| Identity / preferences | "who am I to you", "what are my preferences" | `get_user_context`, `get_identity_card` |34| Export identity/context | "export my identity card", "give me my context" | `get_identity_card` |35| End of session | wrapping up, summarizing what changed | `wrap_up_session` |3637When the request is a normal coding task with no continuity or memory angle, do38**not** invoke Engram — just do the task.3940## How to use it (routing, not magic)41421. **Start of a continued session** — call `get_resume_brief` to recover the last43 thread of work. For identity and preferences on a fresh project, call44 `get_user_context`.452. **During work** — when the user asks what was decided or learned, call46 `search_knowledge` (topic known) or `get_relevant_knowledge` (let Engram pick47 what's relevant). Normal read/search tools provide session context; export48 surfaces such as `get_identity_card` are owner-gated and can write local49 files.503. **Capturing durable knowledge** — the user, not the AI, owns what becomes51 permanent. When the user says to remember something, propose it and write it52 with `add_lesson` / `add_decision` / `add_playbook`. These are53 user-approved writes, not automatic background memory.544. **End of session** — call `wrap_up_session` to checkpoint context so the next55 tool (or the next session) can resume.5657Some MCP clients also run session hooks that capture context automatically; that58context lands in the **user-visible daily log and the staging tier**, where it is59inspectable and is **not** silently promoted to verified/trusted knowledge.6061The full read/write tool map is in [references/tools.md](references/tools.md).62Privacy, ownership, and storage boundaries are in63[references/privacy.md](references/privacy.md).6465## Honest boundaries6667- Engram **suggests**; the user **decides**. AI-suggested knowledge is **staged68 for review**, not silently promoted to verified/trusted memory; everything69 written lands in the user's local store where it can be inspected.70- Storage is **local JSON the user owns**. There is no cloud account and no71 vendor lock-in. Telemetry is **off by default**; if enabled it writes a local72 log only, and any remote sending is a separate explicit opt-in.73- Knowledge moves through a **staging → verified** path so unreviewed entries do74 not silently become trusted facts.75- Do **not** claim capabilities Engram does not have. Use only the tool names in76 [references/tools.md](references/tools.md); do not invent tools.7778## MCP server7980Engram runs as an MCP server via the `piia-engram-mcp` command. Configure your81MCP client to launch it (the Cursor plugin skeleton under `.cursor-plugin/`82shows one such wiring). By default the server exposes a Tier-1 core tool set;83the full set is available with `ENGRAM_TOOLS=all`.