本地优先、可审计的内存层，适用于AI应用和编码代理——Codex、Claude Code、MCP、HTTP、TypeScript和Python。
概览
GoodMemory 是 AI 产品和编码代理的内存层。 该源针对 0.8.3 稳定版本。注册表命令要求发布 [email protected]。发布工作流程会验证 npm 最新和已发布的 GitHub 资产是否对照本地准备好的清单;它不会重建或发布。 它为聊天应用、副驾驶和代理主机提供了一个持久的用户/项目内存循环：写入选定的事实，获取正确的上下文，注入下一回合，审计发生了什么，错误时删除。 GoodMemory 不是大型语言模型（LLM）、代理框架（Agent Framework）、矢量数据库（vector database）或通用的 RAG 系统。它是你的应用或已安装代理主机与模型运行时之间的产品内存层。 - 持久内存API：记忆、回忆、构建上下文、反馈、忘记、导出内存、导入内存和deleteAllMemory。
概述（AI 翻译）
语言：英语 |简体中文
GoodMemory 是 AI 产品和编码代理的内存层。
发布源： 该源针对
0.8.3稳定发布。 注册表命令要求[email protected]必须发布。发布 工作流程验证 npmlatest和已发布的 GitHub 资产 对本地制定的清单进行;不重建或发布。
它为聊天应用、副驾驶和代理主机提供了持久的用户/项目内存循环： 写入选定事实，检索正确的上下文，注入下一回合， 审计发生了什么，错误时删除。
GoodMemory 不是大型语言模型（LLM）、代理框架、矢量数据库或通用 RAG 系统。它是你应用或已安装代理主机之间的产品内存层 以及模型运行时间。
你得到了什么
- 持久内存API：
remember、recall、buildContext、feedback、forget，exportMemory、importMemory和deleteAllMemory。 - 通过
goodmemory setup安装Codex和Claude代码的代理内存， 管理钩子，安装Codex预动作，goodmemory status，只读 MCP，以及选择加入写回。 - 公共写自定义，使用
GoodMemoryConfig.remember
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
GoodMemory
Language: English | 简体中文
GoodMemory is a memory layer for AI products and coding agents.
Release source: this source targets the
0.8.3stable release. Registry commands require[email protected]to be published. The release workflow verifies npmlatestand the already published GitHub assets against the locally prepared manifest; it does not rebuild or publish.
It gives chat apps, copilots, and agent hosts a durable user/project memory loop: write selected facts, retrieve the right context, inject it into the next turn, audit what happened, and delete it when it is wrong.
GoodMemory is not an LLM, agent framework, vector database, or generic RAG system. It is the product memory layer between your app or installed agent host and the model runtime.
What You Get
- Durable memory API:
remember,recall,buildContext,feedback,forget,exportMemory,importMemory, anddeleteAllMemory. - Installed agent memory for Codex and Claude Code through
goodmemory setup, managed hooks, installed Codex pre-action,goodmemory status, read-only MCP, and opt-in writeback. - Public write customization with
GoodMemoryConfig.remember,RememberProfile,rememberRules,RememberInput.annotations, and named extractor ids. - Package exports for
goodmemory,goodmemory/ai-sdk,goodmemory/host, andgoodmemory/httpthrough compileddistartifacts and TypeScript declarations. - Local-first storage: Bun gets durable SQLite by default; explicit Postgres, injected adapters, and embedding providers can be added when needed.
- Evaluation and release evidence paths for deterministic tests, live evals, provider-backed evals, package smoke tests, and quality gates.
OpenAI Build Week 2026
Pre-existing foundation. GoodMemory existed before OpenAI Build Week. The pre-event foundation already included the core memory API, local SQLite/Postgres storage, installed-host integration, and the local Inspector. The hackathon entry is the work added after the submission period opened on July 13, 2026, not the entire repository.
Added during Build Week. Dated commits completed and published v0.6.0,
strengthened generalized retrieval and iterative-recall verification, added
claim-source provenance coverage, hardened installed-host canaries and leakage
audits, and expanded the controlled Codex coding-effect evaluation path. Review
the pre-event-to-Build-Week diff
and its dated commit history for the exact boundary.
How Codex and GPT-5.6 were used. Codex with GPT-5.6 was the primary implementation and verification environment: exploring the repository, implementing and reviewing changes, writing regression tests, reproducing installed-host behavior, and exercising the release and coding-effect evidence paths. GPT-5.6 also powers disclosed non-judge model calls in current evaluation
安装
npx goodmemory -V配置
{
"mcpServers": {
"goodmemory": {
"command": "goodmemory-mcp",
"args": ["--standalone", "--user-id", "YOUR_USER_ID"]
}
}
}