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 工具，用於對專案歷史進行自然語言查詢。