thedotmack/claude-mem

Claude‑Mem – 为 Claude Code 提供持久化记忆

它是什么 – Claude‑Mem 是一个 TypeScript/Node + Bun 插件，为 Claude Code 开发环境（“Claude Code” IDE）添加持久化、可搜索的记忆。它记录工具使用观察，创建语义摘要，并将其存储在本地 SQLite + Chroma 向量存储中。当您启动新的 Claude Code 会话时，存储的记忆会自动注入，使助手能够在完整的项目上下文中继续对话。

工作原理

1. 生命周期钩子 – 为 Claude Code 事件（会话开始、提示提交、工具使用等）安装小型无 shell 命令（claude‑mem hook claude‑code <event>）。
2. 观察者/工作服务 – 本地 HTTP 服务（由 Bun 运行）将观察写入 SQLite 数据库，通过 Chroma 构建向量嵌入，并提供 Web UI 和 API。
3. 混合搜索 – 全文 + 向量搜索允许您使用自然语言查询过去的观察（mem‑search 技能）。MCP 工具（search、timeline、get_observations）实现三步、令牌高效的检索工作流。
4. 云同步（可选） – 记忆可以同步到托管的 cmem.ai 服务，实现跨设备访问。

主要功能

• 跨会话持久化记忆，自动注入 Claude Code。
• 渐进式披露：节省令牌的三步搜索（索引 → 时间线 → 完整详情）。
• 用于实时记忆流和引用 ID 的 Web 查看器 UI。
• 隐私标签（<private>）排除敏感内容。
• 可通过 ~/.claude‑mem/settings.json 配置（模型、端口、上下文注入、语言模式等）。
• 支持多种 IDE/插件：Grok Bot、OpenCode、T3 Code、Antigravity CLI、OMP、Pi、DeepSeek Harness 和 OpenClaw 网关。

开始使用

# 安装并设置（包括可选云记忆的登录）
npx claude‑mem install

或为特定 IDE 安装，例如 npx claude‑mem install --ide opencode。安装程序将钩子启动器添加到您的 PATH 并启动工作服务。

典型工作流

1. 使用 Claude Code 编码；插件记录工具调用和观察。
2. 稍后，让 Claude 回忆某些内容：
   • 使用 mem‑search 技能或 MCP search 工具获取相关 ID 的紧凑列表。
   • 使用 timeline 细化以查看周围上下文。
   • 使用 get_observations 拉取完整详情。
3. Claude 将检索到的记忆注入对话，保持连续性。

适用人群 – 使用 Claude Code（或兼容 IDE）的开发人员，希望他们的 AI 助手保留过去调试会话、设计决策或安全警报的知识，而无需手动重新提供信息。

许可证 – Apache 2.0（核心），ragtime/ 子目录也采用 Apache 2.0。

资源 – 完整文档位于 https://docs.claude‑mem.ai，GitHub issues 用于支持，Discord 社区，以及 X 账号用于更新。