agent-memory
AI 代理的長期記憶執行環境 — 以純 Markdown 為事實來源、本機排名檢索,以及獨立的睡眠時間管理層。Claude Code
agent-memory 是什麼?
AI 代理的長期記憶執行環境 — 以純 Markdown 為事實來源、本機排名檢索,以及獨立的睡眠時間管理層。Claude Code 和 Codex 共用同一個儲存空間。無需 API 金鑰。
agent-memory 概覽
這是什麼
agent-memory 是一個為 AI 代理設計的長期記憶執行環境。它以純 Markdown 檔案作為唯一真相來源,並搭配一個可重建的 SQLite 索引快取。檢索在本機進行並排序,回傳的是檔案路徑而非貼上的文字。寫入操作在對話邊界觸發,而睡眠時段會自動進行合併與遺忘。此儲存空間可由 Claude Code、Codex CLI、Muse Code 以及任何能執行 shell 指令的代理共享。無需 API 金鑰。
主要功能
- Markdown 檔案作為唯一真相來源;SQLite 索引是可刪除且可重建的快取,不會遺失資料。
- 使用 FTS5 索引上的 BM25 進行本機排序檢索,並可選用 RRF 融合的向量外掛。
- 三種讀取路徑:工作階段開始時的確定性 MEMORY.md 注入、BM25/向量檢索,以及純目錄樹。
- 寫入覆蓋在對話邊界觸發;完整對話記錄會先複製,確保不會遺失。
- 睡眠時段的管理層具有權限分級:無人值守時可新增與更新,刪除僅以提案形式出現。
- 函式庫內不含 LLM 客戶端;無需安裝任何 API 金鑰。
- 檔案可攜、可 grep、可 git;索引可透過
rm -rf .index/ && mem rebuild完全重建。
使用情境
- 為 Claude Code、Codex CLI、Muse Code 等 AI 編碼代理提供長期記憶。
- 多個代理使用同一儲存空間進行跨工作階段的知識共享。
- 無需外部 API 依賴的本機離線記憶檢索。
- 透過自動睡眠處理來管理與合併代理記憶。
快速開始
請參閱儲存庫的 README 以取得安裝與快速開始說明。
授權與價格
MIT 授權,開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。