kitfunso/hippo-memory

解決的問題

Hippo 是一個用於 AI 代理的記憶層，可防止代理在切換不同 AI 工具（如 Claude Code、Cursor 和 Codex）時重複犯錯或遺失上下文。與傳統語義搜尋系統保存所有內容不同，Hippo 實作了生物記憶模型，資訊若未透過使用獲得強化，將隨時間衰減，確保代理僅保留高價值的教訓與模式。

工作原理

Hippo 以 SQLite 為後端，配備 Markdown 鏡像，並在三個生物層面運作：僅會話的緩衝區、帶時間戳的事件記憶儲存，以及用於壓縮模式的語義儲存。

• 衰減與強化：記憶具有預設半衰期（例如 7 天）。回憶記憶會延長其半衰期，而將記憶標記為錯誤則會使其衰減更慢。
• 睡眠整合：hippo sleep 命令將相關事件記憶合併為穩定的語義模式，並清除已衰減的資訊。
• 整合：透過鈎子（例如修補 CLAUDE.md 或 .cursorrules）與代理框架整合，可從 ChatGPT、Slack 和 git 提交歷史匯入資料。
• 檢索：記憶依相關性、強度與新近性排序，並可受令牌預算約束，避免上下文過載。

適用對象

使用多個 AI 編碼代理與 CLI 工具，希望擁有持久、工具無關的記憶儲存，並能從專案歷史中學習、防止重複錯誤的開發者。

主要亮點

• 生物記憶模型：實作衰減、透過檢索強化，以及基於睡眠的整合。
• 工具無關：適用於 Claude Code、Cursor、Codex 及任何 MCP 客戶端。
• Git 結合學習：自動從 git 倉庫的修復、還原與錯誤提交中提取經驗教訓。
• 溯源與治理：每條記憶皆記錄其來源（類型、範圍、所有者），並支援 GDPR 合規刪除。
• 置信度層級：將記憶標記為已驗證、已觀察、已推論或已過期，協助代理判斷信任度。
• 結果反饋：允許使用者標記回憶的記憶為有用或無用，以調整其衰減率。