用途：Engram 是一套持久记忆协议，用于让 AI 代理在会话之间、上下文压缩之后仍能记住并复用历史信息。协议要求常驻启用，代理需主动保存决策、约定、缺陷与发现，无需等待用户请求。
主要能力：核心工具在会话启动时由 UserPromptSubmit 钩子自动加载，包括 mem_save、mem_search、mem_context、mem_session_summary、mem_get_observation、mem_save_prompt、mem_current_project、mem_judge、mem_compare。延迟工具需用 ToolSearch 加载，包括 mem_update、mem_review、mem_pin、mem_unpin、mem_suggest_topic_key、mem_session_start、mem_session_end、mem_doctor、mem_capture_passive。
使用方式：在做出决策或约定、完成工作（如修复 Bug）、获得非显而易见的发现、用户确认或否决方案、用户表达偏好之后调用 mem_save。保存时可填 title、type、scope、可选 topic_key 以及 content（含 What、Why、Where、Learned）。同一主题须用相同 topic_key 进行更新，不同主题不得互相覆盖。回忆时先调用 mem_context，再按关键词调用 mem_search，必要时用 mem_get_observation 获取完整内容。结束会话前必须调用 mem_session_summary，包含 Goal、Instructions、Discoveries、Accomplished、Next Steps、Relevant Files；压缩后应先调用 mem_session_summary，再调用 mem_context 恢复上下文。
限制与故障处理：若工具意外不可用，需重新运行 engram setup claude-code 并重启 Claude Code；若 MCP 配置为符号链接或其他非常规路径，需先手动替换再运行 setup。Claude 插件会在工具运行前把 session_id 绑定到 Claude Code 的权威会话身份，不得自行编造、复用或覆盖该值。记忆操作属于内部记录，不应替代面向用户的最终回答；即使记忆操作失败，也须照常发出回答。