Engram Persistent Memory Protocol
Persistent memory for AI coding agents—auto-save decisions and discoveries across sessions and compactions.
The skill requires the agent to proactively save memories and enforces a session-end protocol without requiring explicit user confirmation, and lacks explicit guidance on handling sensitive data in memory storage. The skill exhibits least privilege in terms of permissions; the MCP tools and HTTP server data flow are visible, but the HTTP server defaults to being open if token is not set, which could expose data. Installation and setup info provided, attribution clear. Deductions: lacks user confirmation or sensitive-data transparency.
The skill provides a clear protocol with mandatory actions and fallback (rerun setup), but no explicit error handling or failure-feedback details for abnormal inputs. README mentions tests and CI workflow, offering some evidence, but static review prevents full verification. Deductions: lack of error messages or test coverage evidence.
Targets AI coding agents with persistent memory needs; scenario and boundaries are clear, triggers defined, non-fit cases evident. It works with Chinese and English languages and runs locally, so no internet dependency. Deductions: limited evidence beyond default scenarios.
Documentation is well-layered: README, DOCS, INSTALLATION, etc. License is MIT. But no version or changelog information provided. Deductions: missing changelog or versioning.
Goals and benefits are clear; the skill provides detailed instructions and tool usage. It likely completes the core task of persisting memory, but direct usability or output verification is not proven without execution. Deductions: no execution evidence.
CI workflow with go test ./... and e2e tests provides some verifiability, but static review limits score. No independent reproduction performed. Deductions: no independent execution evidence.
- The skill is designed to be always active and mandates memory saving and session-end protocols; administrators should ensure users are aware of this behavior and configure permissions as needed.
- Default HTTP server is unauthed; consider setting ENGRAM_HTTP_TOKEN to protect local data if exposed.
- The skill does not explicitly prohibit saving sensitive information; ensure user data is not stored in memory unless explicitly consented.
- The skill relies heavily on the external engram binary and MCP server; ensure these components remain updated and available to avoid disruption.
- The beta features should be used with isolated test environments to avoid impacting production.
What does this skill do, and when should you use it?
This protocol is mandatory and always active, requiring the agent to proactively save architecture decisions, bug fixes, user preferences, and discoveries into Engram's SQLite store. It leverages an MCP server for tools like mem_save and a session-close summary protocol to ensure continuity. Installation involves running `engram setup codex` and restarting Codex; tools auto-load via the UserPromptSubmit hook.
Calls mem_save immediately after relevant events (decisions, completed work, discoveries, user confirmations/rejections) with structured fields (title, type, What/Why/Where/Learned). Provides mem_context and mem_search for retrieval, and mem_session_summary to log session end summaries. After compaction, it persists a summary and recovers context. All actions go through the MCP server.
- A developer fixes a stubborn bug and wants the root cause remembered next session.
- A team establishes a coding convention and expects the agent to enforce it consistently.
- A user expresses a preference for a tool or framework, and future work should follow it.
- After context compaction, quickly restore the session's state.
- At the start of a new session, the user asks about prior work; the agent auto-searches memory.
What are this skill's strengths and limitations?
- Proactive saving reduces forgetting
- Preserves context across sessions and compactions
- Structured memory with topic keys and upsert
- Automatic tool loading—no manual search
- Supports project and personal scopes
- Depends on external engram binary and MCP config; setup failures break tools
- Relies on agent adherence; otherwise memory may be incomplete
- MCP-only, not reachable over HTTP or Docker networks
- No test suite or evidence of stability
How do you install this skill?
- Install Engram:
brew install gentleman-programming/tap/engram(other platforms per docs). 2. Runengram setup codexand restart Codex. 3. Ensure MCP tools are available; if missing, rerun setup and restart.
How do you use this skill?
No manual activation is needed—the protocol auto-runs. The agent triggers mem_save on relevant events and mem_session_summary at session end. Users can prompt with phrases like 'remember how we solved this last time?' to trigger search.