Agent Memory System

Agent Memory System

Agent Memory System 是一個開源、安全至上的上下文和記憶層,它將存儲庫掃描到持久的 Markdown/JSON 索引中,通過 Git 感知更新和 CI 門保持新鮮度,並通過工作日誌和依賴關係圖智能實現跨代理交接。
https://ravbyte-ai.github.io/agent-memory-system?ref=producthunt&utm_source=aipure
Agent Memory System

產品資訊

更新時間:2026年05月18日

什麼是 Agent Memory System

Agent Memory System 是一個開源的“上下文基礎設施”工具,它為代碼存儲庫添加了一個持久的記憶層,以便 AI 助手可以在會話之間和工具之間保留和恢復項目上下文。由 RAVBYTE TECHNOLOGIES PRIVATE LIMITED 維護(MIT 許可並開放社區貢獻),它生成一個結構化的 `memory/` 文件夾(例如,上下文索引、指南、工作日誌和交接筆記),任何代理——Codex、Claude、Cursor、Antigravity 等——都可以讀取,以快速理解代碼庫、最近的執行歷史和當前工作狀態。

Agent Memory System 的主要功能

Agent Memory System 是一個開源的「上下文基礎設施」層,它掃描儲存庫(以及包含多個儲存庫的整個工作空間),以生成持久、代理可讀的記憶工件——索引、指南、架構圖和工作日誌——這樣 AI 編碼代理(Codex、Claude、Cursor 等)就可以更快地瀏覽代碼庫,跨會話恢復工作,並在無需重新閱讀所有內容的情況下交接任務。它強調通過 git 感知的維護實現自動維護,通過基於圖的依賴智能來理解變更的影響範圍,以及避免洩露機密同時仍保留有用操作上下文的安全防護措施。
工作空間和儲存庫掃描到結構化記憶: 一鍵掃描可檢測多個文件夾/儲存庫中的清單、API、配置、測試、儲存提示、文檔和關鍵結構,然後寫入可攜式 Markdown 記憶文件以及任何代理都可以使用的主題索引(例如,context-index.json)。
Git 感知維護和新鮮度門檻: 維護模式(例如,`--since main`)根據結構變更刷新記憶並驗證輸出,以防止上下文漂移;CI 檢查可以要求 PR 中更新記憶。
跨代理連續性(工作日誌 + 交接): 在 JSONL 工作日誌中捕獲檢查點、命令、觸摸的文件、阻礙和下一步,並生成代理交接文件,以便新代理可以以最少的恢復令牌即時恢復。
用於影響範圍分析的圖智能: 內置的靜態分析映射依賴關係和架構層次,可以快速查詢如果 API 或模組更改會破壞什麼,並減少試錯導航。
代理原生約定和技能包裝器: 提供關於讀取哪些記憶、何時刷新記憶以及如何執行交接的可攜式指南——旨在跨多個助手和未來的代理主機工作。
安全優先的記憶生成: 避免生成/供應商路徑,記錄環境變數名稱(而非機密值),標記明顯的機密模式,並標記推斷的內容,以便代理知道什麼需要驗證。

Agent Memory System 的使用案例

軟體工程團隊(多儲存庫單體倉儲): 為大型工作空間創建一個持久的上下文層,以便代理和開發人員可以快速找到正確的文件,理解架構,並減少跨任務重複的「代碼庫重新發現」。
AI 輔助代碼審查和 CI 工作流程: 使用 PR 新鮮度門檻來確保記憶與代碼變更保持一致,提高審查質量並減少因過時的架構假設引起的迴歸。
諮詢和代理交接: 生成標準化的交接工件(工作日誌 + 交接文件),以便新工程師或新代理可以在無需冗長入職或重複解釋的情況下接手客戶專案。
企業現代化和重構計畫: 利用依賴/架構圖來估計影響範圍,規劃安全的重構,並引導代理在舊有系統中找到正確的層次和模組。
開發者產品的客戶支援/解決方案工程: 維護一個結構化、安全可共享的儲存庫結構內部記憶、常用命令和經過驗證的工作流程,以便支援工程師和代理可以更快地重現問題並提出修復方案。

優點

開源且與代理無關:旨在通過可攜式記憶工件跨 Codex、Claude、Cursor 以及其他/未來代理工作。
強大的連續性原語:工作日誌 + 交接減少了恢復任務或切換代理時的恢復時間和令牌消耗。
設計上注重安全:避免機密值和生成路徑,同時仍捕獲操作上有用的上下文。
變更影響感知:基於圖的依賴智能幫助代理推理影響範圍,而不是猜測。

缺點

需要操作紀律:團隊可能需要連接 CI 檢查並持續運行維護工作流程以防止漂移。
靜態分析和掃描可能會遺漏僅在運行時的行為:某些架構真相可能仍需要在代碼/測試中進行驗證。
如果沒有調整,記憶工件可能會變得嘈雜:大型或快速變化的儲存庫可能需要配置/驗證以保持輸出高信號。

如何使用 Agent Memory System

1) 在您的存儲庫中初始化 Agent Memory System: 從存儲庫根目錄運行:`npx @ravbyte/agent-memory-system@latest init`。這將生成 `memory/` 文件夾和關鍵的啟動工件,例如 `memory/context-index.json`、`memory/09-agent-guidelines.md` 和 `memory/10-agent-worklog.md`。
2) (可選) 全局安裝 CLI 以便重複使用: 如果您喜歡持久的 `agent-memory` 命令,請運行:`npm install -g @ravbyte/agent-memory-system@latest`。
3) 掃描存儲庫以構建/更新記憶層: 運行掃描以映射存儲庫(清單、路由、API、配置、測試、存儲提示、文檔等),並編寫 Markdown + 代理可以讀取的主題索引。示例:`agent-memory scan --json`。
4) 使用生成的記憶工件作為代理的起始上下文: 將您的編碼代理(Codex/Claude/Cursor/等)指向 `memory/` 輸出——特別是 `memory/context-index.json`——這樣它就可以快速找到正確的文件並理解架構,而無需重新遍歷代碼庫。
5) 隨著存儲庫的變化保持記憶新鮮(維護模式): 在結構性 Git 更改之後,刷新記憶以避免漂移:`agent-memory maintain --since main`。這會檢測自指定引用/分支以來的更改,並相應地更新 `memory/`,並進行驗證,以便陳舊的上下文不會無聲地持久存在。
6) 在代理會話期間記錄進度(檢查點工作日誌): 當代理完成有意義的工作時,將檢查點條目寫入 JSONL 工作日誌,以便未來的會話可以準確恢復。示例:`agent-memory worklog checkpoint --agent codex --message "implemented scanner"`。
7) 為下一個代理/會話創建交接: 當您停止工作(或希望另一個代理繼續)時,生成一個交接摘要:`agent-memory worklog handoff --agent codex --message "tests pass; next publish pages"`。這會生成 `memory/agent-handoff.md` 以實現快速跨會話恢復。
8) 使用交接在新的會話中恢復工作: 在下一個會話中(相同或不同的代理),首先閱讀 `memory/agent-handoff.md` 以及 `memory/agent-worklog.jsonl` 中的相關條目(或引用的文件),以便在不重新解釋先前的決策、命令和障礙的情況下繼續。
9) 添加 CI/審查紀律,使記憶保持準確: 採用一種工作流程,其中更改結構的 PR 也會刷新 `memory/`(通過 `agent-memory maintain --since main`),並在合併之前運行項目的檢查(類型檢查/測試/構建以及任何記憶驗證門),防止陳舊的上下文進入審查。

Agent Memory System 常見問題

Agent Memory System 是一個開源的上下文基礎設施,它為工作區中的儲存庫提供持久的記憶層,使專案上下文、執行歷史和交接在會話之間以及代理/工具(例如 Codex、Claude、Cursor)之間保持不變。

与 Agent Memory System 类似的最新 AI 工具

Gait
Gait
Gait 是一個集成 AI 辅助代碼生成和版本控制的協作工具,使團隊能夠高效地追蹤、理解和共享 AI 生成代碼的上下文。
invoices.dev
invoices.dev
invoices.dev 是一個自動化發票平台,直接從開發者的 Git 提交生成發票,並具有 GitHub、Slack、Linear 和 Google 服務的集成能力。
EasyRFP
EasyRFP
EasyRFP 是一個 AI 驅動的邊緣計算工具包,通過深度學習技術簡化 RFP(請求提案)回應並實現實時田間表型。
Cart.ai
Cart.ai
Cart.ai 是一個 AI 驅動的服務平台,提供全面的業務自動化解決方案,包括編碼、客戶關係管理、視頻編輯、電商設置和定制 AI 開發,並提供 24/7 支持。