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
tester-army/e2e(已於 2026-10-05 推過),故改推第 2 名。這是什麼
Claude-Mem 是一套替 AI coding agent 準備的跨 session 持久記憶系統。它的核心目標不是再做一個聊天紀錄工具,而是把 agent 在工作過程中的工具使用、觀察、決策與摘要自動保存,之後在新 session 啟動或搜尋時,把相關脈絡重新帶回來。README 將它描述為主要面向 Claude Code,但 metadata 與說明也列出 OpenCode、Codex、Gemini、Hermes、Copilot 等多種 agent/IDE 整合方向。架構上,它由 lifecycle hooks、worker service、SQLite、Chroma vector database 與 mem-search skill 組成:hooks 負責捕捉事件,worker 提供本機 HTTP API 與 web viewer,SQLite 保存 sessions、observations、summaries,Chroma 則提供語意與關鍵字混合搜尋。
為什麼上榜
這個專案今天以 96,622 stars、單日新增 534 stars 的熱度被選中,原因很直接:AI coding agent 的使用正在從「單次問答」走向長時間專案協作,而最大的痛點之一就是上下文會斷。Claude-Mem 把「記住過去工作脈絡」包成安裝器、hooks、搜尋工具與可視化 UI,而不是要求使用者手動整理筆記。它的差異點在於強調自動化與 token 成本控制:README 提到 progressive disclosure 與分層搜尋流程,先用 compact index 找線索,再視需要抓 timeline 與完整 observations,避免一開始就把大量歷史內容塞回模型。
適合誰,可以拿來做什麼
它最適合已經深度使用 Claude Code/OpenCode/Codex 類工具 的開發者,特別是會在同一個專案上反覆開新 session、需要追蹤 bugfix、設計決策、安全提醒或歷史操作脈絡的人。團隊或個人都可以把它當成 agent 的「專案記憶層」:讓新對話知道之前做過哪些嘗試、哪些檔案或決策值得回看。上手門檻主要在 Node.js 與本機工具鏈;README 的 system requirements 寫明需要 Node.js 20+,Bun 與 uv 可由安裝流程自動處理,SQLite 則為 bundled。若你重視隱私,README 也提到可用 <private> 標籤排除敏感內容不被儲存。
上手
README 給的主路徑是透過 npx 安裝,而不是全域 npm 套件;它特別提醒 npm install -g claude-mem 只會安裝 SDK/library,不會註冊 plugin hooks 或 worker service。一般安裝可用:
npx claude-mem install
針對不同環境,也可指定 IDE/宿主,例如:
npx claude-mem install --ide opencode
npx claude-mem install --ide t3code
npx claude-mem install --ide antigravity
npx claude-mem install --ide omp
若是 OpenClaw gateway,README 提供另一個安裝方式:
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
README 重點摘要
- Claude-Mem 透過 5 個 lifecycle hooks、worker service、SQLite 與 Chroma,保存並檢索 agent 工作脈絡。
- 內建 MCP search tools:
search、timeline、get_observations,主打先篩選再取完整內容以節省 token。 - 提供 web viewer UI,可查看即時 memory stream,並能透過 observation ID 做引用。
- 支援
<private>標籤排除敏感內容,並有細粒度的 context injection 設定。 - 系統需求包含 Node.js 20+、最新版 Claude Code plugin 支援、Bun、uv 與 SQLite;Bun/uv 依 README 可由安裝流程自動處理。