thedotmack/claude-mem

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

解决的问题

Claude-Mem 为 Claude Code 提供持久化记忆，使 AI 能够在不同的会话之间保持知识的连续性。它防止了在会话结束或重新连接时项目上下文的丢失，确保之前的交互观察结果和工具使用情况得以保留并可供未来使用。

工作原理

该系统结合使用生命周期钩子（如 SessionStart 和 PostToolUse）来自动捕获观察结果并生成语义摘要。这些摘要存储在 SQLite 数据库和 Chroma 向量数据库中，用于混合语义和关键词搜索。由 Bun 管理的本地工作服务提供 HTTP API 和 Web 查看器 UI。为了检索信息，它通过 MCP 工具采用“渐进式披露”策略，即 Claude 首先搜索结果的紧凑索引，然后查看时间线，最后仅针对特定 ID 获取完整详情以节省 Token。

适用对象

使用 Claude Code、OpenCode 或 Antigravity CLI，并希望其 AI 代理能够跨会话记住项目历史、错误修复和技术决策的开发人员。

亮点

持久化记忆：上下文在会话间自动保留。
渐进式披露：3 层搜索工作流（search $ ightarrow$ timeline $ ightarrow$ get_observations）可降低高达 10 倍的 Token 成本。
混合搜索：结合全文 SQLite 搜索与 Chroma 向量数据库，实现智能检索。
隐私控制：支持 <private> 标签，将敏感内容排除在存储之外。
Web 查看器 UI：在浏览器中提供记忆的实时流。
MCP 集成：提供 4 个 MCP 工具，用于对项目历史进行自然语言查询。