pax-beehive/paxm

解決的問題

PAXM 是一個記憶適配器，可以防止使用者向不同的 AI 程式設計代理重複解釋專案上下文、架構決策和操作約束。它建立了一個統一的記憶層，使得由一個代理（例如 Codex）擷取的決策可以被另一個代理（例如 Claude Code）召回，確保專案上下文在不同工作階段和不同工具之間保持一致。

工作原理

PAXM 作為 AI 代理與各種記憶提供者之間的中間層。它提供兩種主要的互動路徑：

• Active Recall（主動召回）：使用者可以使用 CLI、MCP (Model Context Protocol) 伺服器或特定的代理技能來顯式儲存或檢索記憶。
• Passive Memory（被動記憶）：利用生命週期鉤子，PAXM 會在代理回應之前自動召回相關上下文，並在回應完成後擷取已完成的對話輪次。

為了確保程式設計工作階段不會變慢，被動寫入會被提交到本地持久化隊列中，並在背景傳送給記憶提供者。

適用對象

使用多個 AI 程式設計代理（如 Cursor、Claude Code、Codex、OpenCode 等）的開發者，他們需要一個持久的、共享的專案記憶，而不是綁定在單一代理的內部歷史紀錄中。

亮點

• 跨代理相容性：適用於廣泛的代理，包括 Codex、Claude Code、OpenCode、Pi、Cursor、TRAE、Kimi Code、ZCode 和 Cline。
• 可互換的提供者：支援本地 SQLite（零設定，無需 API 金鑰）、Zep、Mem0、MemOS、OpenViking 以及自定義 JSON-RPC 提供者。
• 非阻塞整合：被動記憶擷取在背景進行，以避免阻礙代理的響應時間。
• MCP 伺服器支援：可以作為本地 stdio MCP 伺服器執行，為任何相容 MCP 的用戶端提供記憶工具。
• 本地優先選項：包含內建的 SQLite 提供者，使用 FTS5 和 BM25 檢索，無需外部 LLM 或嵌入服務。