thedotmack/claude-mem

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

是什么 – Claude‑Mem 是一个基于 TypeScript/Node 的插件，为 Claude Code（Anthropic 的 IDE 助手）添加了 持久且可搜索的记忆 功能。它监控开发者的工具使用情况，将观察结果转化为紧凑的语义摘要，存储在本地的 SQLite + Chroma 向量数据库中，并使相关上下文可供未来的 Claude 会话使用。

主要功能

• 自动捕获 – 通过会话开始、提示提交、工具使用后、停止、会话结束等生命周期钩子自动记录观察结果，无需用户复制粘贴。
• 混合搜索 – 支持全文 + 向量（Chroma）搜索，可通过 mem‑search 技能使用自然语言查询过往工作。
• 三步节省 token 的工作流 – search → timeline → get_observations 可将 Claude 需要读取的文本量减少约 10 倍。
• Web UI 与工作器服务 – 基于本地 Bun 的 HTTP 服务器可显示实时记忆流，提供 API 接口，并可向 Slack/Discord/Telegram 推送更新。
• 隐私控制 – 使用 <private> 标签可排除敏感片段；可配置哪些观察结果注入 Claude 的上下文。
• 云同步选项 – 可选的 CMEM .ai 服务用于备份 SQLite 存储；否则所有数据均保留在本地。
• 多 IDE 支持 – 可通过 npx claude-mem install --ide grok-bot, opencode, antigravity 或直接从 Claude Code 插件市场安装。

快速上手

1. 运行 npx claude-mem install（或 IDE 特定命令）。安装程序注册插件，启动 Bun 工作者，并提示登录以获取记忆密钥（可选——使用 --provider host 可完全离线运行）。
2. Claude Code 重启后，从下一个会话开始，之前的观察结果将自动出现。
3. 使用内置的 mem‑search 技能或 MCP 工具（search, timeline, get_observations）检索过往笔记。

配置 – 设置文件位于 ~/.claude-mem/settings.json。可切换：

• 会话开始时注入的来源（CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES）。
• AI 模型/提供商（Anthropic、OpenRouter、Gemini）。
• 语言/模式（code, code--zh 等）。
• 端口、日志级别及其他工作器选项。

适用人群 – 依赖 Claude Code 进行代码生成或调试，希望助手在重启、CI 运行或不同机器间仍能保留知识的开发者。

许可证 – Apache 2.0（包含独立的 ragtime/ 子模块）。