让你的 Codex 智能体记住过往决策、查找相关上下文，并从每次会话中积累经验，跨工具延续记忆。

Codex 复用型记忆包

Codex 可以获得一套可复用的记忆工作流：会话开始先读 Working Memory，需要时搜索过往内容，用户要求时保存真实线程，出现重要结论时进行蒸馏。

在 Codex、Claude Code、Gemini、Cursor 之间切换，不丢失上下文。这个 Codex 包会稳定完成 Working Memory 启动，然后把搜索、蒸馏、保存能力作为技能交给 Codex 使用。和 Claude Code、OpenClaw 这类带宿主钩子的集成不同，这里更依赖项目级 AGENTS.md 来把行为收紧。

如何确认安装成功

开始一次会话，问「我在做什么？」你应该看到最近的工作重点和优先事项。你也可以直接运行 $nowledge-mem:working-memory，确认会话里已经出现可手动触发的 Working Memory 命令。如果是首次使用，运行 $nowledge-mem:status 检查连接状态。

开始之前

Nowledge Mem 已在本地运行（安装指南），或有可访问的远程 Mem 服务
已安装 Codex CLI
nmem CLI 在你的 PATH 中

设置

安装 `nmem`

# 方式一：uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version

# 方式二：pip
pip install nmem-cli

如果 Nowledge Mem 桌面应用已在同一台机器上运行，推荐的方式是 Settings → Preferences → Developer Tools → Install CLI。

安装插件

请使用插件缓存路径，不要用旧路径

如果你看到旧文档让你把插件复制到 ~/.codex/plugins/nowledge-mem，请忽略。当前版本的 Codex 会从 ~/.codex/plugins/cache/local/nowledge-mem/local/ 加载本地插件。

# 克隆 community 仓库
git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community

# 复制到 Codex 插件缓存目录
mkdir -p ~/.codex/plugins/cache/local/nowledge-mem/local
cp -R /tmp/nowledge-community/nowledge-mem-codex-plugin/. \
  ~/.codex/plugins/cache/local/nowledge-mem/local/
rm -rf /tmp/nowledge-community

在 ~/.codex/config.toml 中添加两项配置：

[features]
plugins = true

[plugins."nowledge-mem@local"]
enabled = true

安装完成后重启 Codex。

可选：添加项目级引导

将插件的 AGENTS.md 复制或合并到你的项目根目录，增强该仓库中的记忆行为：

cp ~/.codex/plugins/cache/local/nowledge-mem/local/AGENTS.md ./AGENTS.md

如果你的项目已经有 AGENTS.md，请把 Nowledge 部分合并进去，而不是直接覆盖。这一步能明显改善 continuation-heavy 仓库里只读 Working Memory、不继续搜索的情况。

需要远程 Mem 时配置

nmem config client set url https://mem.example.com
nmem config client set api-key nmem_your_key

nmem 的连接优先级：

--api-url / --api-key 参数
NMEM_API_URL / NMEM_API_KEY 环境变量
~/.nowledge-mem/config.json
默认值

项目级安装（可选方案）

除了全局安装，也可以把插件打包进项目仓库，通过 Codex marketplace 文件让 Codex 自动发现。这样，克隆仓库的人都能使用该插件。

git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community
mkdir -p .agents
cp -r /tmp/nowledge-community/nowledge-mem-codex-plugin ./.agents/nowledge-mem
rm -rf /tmp/nowledge-community
mkdir -p .agents/plugins

创建 .agents/plugins/marketplace.json：

{
  "name": "local",
  "plugins": [
    {
      "name": "nowledge-mem",
      "source": {
        "source": "local",
        "path": "./.agents/nowledge-mem"
      },
      "policy": {
        "installation": "INSTALLED_BY_DEFAULT"
      }
    }
  ]
}

path 相对于仓库根目录，而非 marketplace 文件本身。仍然需要在 ~/.codex/config.toml 中添加上方配置条目。

更新

用最新版本替换插件文件：

git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community-update
cp -R /tmp/nowledge-community-update/nowledge-mem-codex-plugin/. \
  ~/.codex/plugins/cache/local/nowledge-mem/local/
rm -rf /tmp/nowledge-community-update

然后重启 Codex。

技能

技能	触发条件	功能
`$nowledge-mem:working-memory`	会话开始、”我在做什么”	读取当天的工作记忆简报
`$nowledge-mem:search-memory`	涉及过往工作、过去的决策	搜索记忆和对话，支持逐层深入查看
`$nowledge-mem:save-thread`	"保存这次会话"	通过 `nmem t save --from codex` 导入真实 Codex 会话
`$nowledge-mem:distill-memory`	做出决策、发现经验教训	主动将有价值的洞察保存为记忆
`$nowledge-mem:status`	"Mem 能用吗"、出错时	检查服务器连接和配置状态

直接使用 `nmem`

智能体也可以直接调用 nmem 命令：

nmem --json wm read
nmem --json m search "auth token rotation" --mode deep
nmem --json t save --from codex -p . -s "完成了 auth 重构"
nmem --json m add "JWT 刷新失败源于时钟偏移" --title "JWT 刷新失败追溯到时钟偏移" --importance 0.9 --unit-type learning -l auth -s codex

默认情况下，nmem t save --from codex 会去 ~/.codex 里找会话。如果 Codex Home 在其他位置，设置 CODEX_HOME 即可。

从自定义提示词迁移

如果之前使用的是 nowledge-mem-codex-prompts，这个插件完整覆盖了原有功能：

安装插件（见上方步骤）。
删除旧提示词：rm ~/.codex/prompts/{read_working_memory,search_memory,save_session,distill}.md
插件技能一一对应替代旧提示词。

旧提示词	新技能
`/prompts:read_working_memory`	`$nowledge-mem:working-memory`
`/prompts:search_memory`	`$nowledge-mem:search-memory`
`/prompts:save_session`	`$nowledge-mem:save-thread`
`/prompts:distill`	`$nowledge-mem:distill-memory`
（无）	`$nowledge-mem:status`

常见问题

找不到 nmem 命令

用 pip install nmem-cli 安装，或使用 uvx --from nmem-cli nmem。参见安装指南。

无法连接服务器

运行 nmem status 和 nmem config client show 检查远程配置是否正确。参见远程访问。

技能没有出现

安装插件后需重启 Codex。确认 ~/.codex/config.toml 中同时包含 [features] plugins = true 和 [plugins."nowledge-mem@local"] enabled = true。

显示 "plugin is not installed"

确认插件文件位于 ~/.codex/plugins/cache/local/nowledge-mem/local/，并且该目录内存在 .codex-plugin/plugin.json。

只会读取 Working Memory，不继续搜索或蒸馏

这通常说明 Codex 只执行了最稳定的启动动作，但当前仓库里的行为引导还不够强。把插件里的 AGENTS.md 合并到项目根目录，再用类似「我们之前对这个发布流程做过什么决定？」或「搜索一下这个回归问题之前的处理」这样的 continuation 型问题再试一次。

开始之前

Nowledge Mem 已在本地运行（安装指南），或有可访问的远程 Mem 服务
已安装 Codex CLI
nmem CLI 在你的 PATH 中

设置

安装 `nmem`

# 方式一：uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --version

# 方式二：pip
pip install nmem-cli

如果 Nowledge Mem 桌面应用已在同一台机器上运行，推荐的方式是 Settings → Preferences → Developer Tools → Install CLI。

安装插件

请使用插件缓存路径，不要用旧路径

如果你看到旧文档让你把插件复制到 ~/.codex/plugins/nowledge-mem，请忽略。当前版本的 Codex 会从 ~/.codex/plugins/cache/local/nowledge-mem/local/ 加载本地插件。

# 克隆 community 仓库
git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community

# 复制到 Codex 插件缓存目录
mkdir -p ~/.codex/plugins/cache/local/nowledge-mem/local
cp -R /tmp/nowledge-community/nowledge-mem-codex-plugin/. \
  ~/.codex/plugins/cache/local/nowledge-mem/local/
rm -rf /tmp/nowledge-community

在 ~/.codex/config.toml 中添加两项配置：

[features]
plugins = true

[plugins."nowledge-mem@local"]
enabled = true

安装完成后重启 Codex。

可选：添加项目级引导

将插件的 AGENTS.md 复制或合并到你的项目根目录，增强该仓库中的记忆行为：

cp ~/.codex/plugins/cache/local/nowledge-mem/local/AGENTS.md ./AGENTS.md

需要远程 Mem 时配置

nmem config client set url https://mem.example.com
nmem config client set api-key nmem_your_key

nmem 的连接优先级：

--api-url / --api-key 参数
NMEM_API_URL / NMEM_API_KEY 环境变量
~/.nowledge-mem/config.json
默认值

项目级安装（可选方案）

除了全局安装，也可以把插件打包进项目仓库，通过 Codex marketplace 文件让 Codex 自动发现。这样，克隆仓库的人都能使用该插件。

git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community
mkdir -p .agents
cp -r /tmp/nowledge-community/nowledge-mem-codex-plugin ./.agents/nowledge-mem
rm -rf /tmp/nowledge-community
mkdir -p .agents/plugins

创建 .agents/plugins/marketplace.json：

{
  "name": "local",
  "plugins": [
    {
      "name": "nowledge-mem",
      "source": {
        "source": "local",
        "path": "./.agents/nowledge-mem"
      },
      "policy": {
        "installation": "INSTALLED_BY_DEFAULT"
      }
    }
  ]
}

path 相对于仓库根目录，而非 marketplace 文件本身。仍然需要在 ~/.codex/config.toml 中添加上方配置条目。

更新

用最新版本替换插件文件：

git clone https://github.com/nowledge-co/community.git /tmp/nowledge-community-update
cp -R /tmp/nowledge-community-update/nowledge-mem-codex-plugin/. \
  ~/.codex/plugins/cache/local/nowledge-mem/local/
rm -rf /tmp/nowledge-community-update

然后重启 Codex。

技能

技能	触发条件	功能
`$nowledge-mem:working-memory`	会话开始、”我在做什么”	读取当天的工作记忆简报
`$nowledge-mem:search-memory`	涉及过往工作、过去的决策	搜索记忆和对话，支持逐层深入查看
`$nowledge-mem:save-thread`	"保存这次会话"	通过 `nmem t save --from codex` 导入真实 Codex 会话
`$nowledge-mem:distill-memory`	做出决策、发现经验教训	主动将有价值的洞察保存为记忆
`$nowledge-mem:status`	"Mem 能用吗"、出错时	检查服务器连接和配置状态

直接使用 `nmem`

智能体也可以直接调用 nmem 命令：

nmem --json wm read
nmem --json m search "auth token rotation" --mode deep
nmem --json t save --from codex -p . -s "完成了 auth 重构"
nmem --json m add "JWT 刷新失败源于时钟偏移" --title "JWT 刷新失败追溯到时钟偏移" --importance 0.9 --unit-type learning -l auth -s codex

默认情况下，nmem t save --from codex 会去 ~/.codex 里找会话。如果 Codex Home 在其他位置，设置 CODEX_HOME 即可。

从自定义提示词迁移

如果之前使用的是 nowledge-mem-codex-prompts，这个插件完整覆盖了原有功能：

安装插件（见上方步骤）。
删除旧提示词：rm ~/.codex/prompts/{read_working_memory,search_memory,save_session,distill}.md
插件技能一一对应替代旧提示词。

旧提示词	新技能
`/prompts:read_working_memory`	`$nowledge-mem:working-memory`
`/prompts:search_memory`	`$nowledge-mem:search-memory`
`/prompts:save_session`	`$nowledge-mem:save-thread`
`/prompts:distill`	`$nowledge-mem:distill-memory`
（无）	`$nowledge-mem:status`

常见问题

找不到 nmem 命令

用 pip install nmem-cli 安装，或使用 uvx --from nmem-cli nmem。参见安装指南。

无法连接服务器

运行 nmem status 和 nmem config client show 检查远程配置是否正确。参见远程访问。

技能没有出现

安装插件后需重启 Codex。确认 ~/.codex/config.toml 中同时包含 [features] plugins = true 和 [plugins."nowledge-mem@local"] enabled = true。

显示 "plugin is not installed"

确认插件文件位于 ~/.codex/plugins/cache/local/nowledge-mem/local/，并且该目录内存在 .codex-plugin/plugin.json。

只会读取 Working Memory，不继续搜索或蒸馏

Codex CLI

开始之前

设置

安装 `nmem`

安装插件

可选：添加项目级引导

需要远程 Mem 时配置

项目级安装（可选方案）

更新

技能

直接使用 `nmem`

从自定义提示词迁移

常见问题

相关内容

On this page

Codex CLI

开始之前

设置

安装 `nmem`

安装插件

可选：添加项目级引导

需要远程 Mem 时配置

项目级安装（可选方案）

更新

技能

直接使用 `nmem`

从自定义提示词迁移

常见问题

相关内容

On this page