Codex CLI
通过自定义提示词、可选的 AGENTS.md 指导,以及直接调用 nmem CLI,在 Codex 中使用 Nowledge Mem。
提示词原生的工作流包
Codex 现在已经有自定义提示词、AGENTS.md、技能与 MCP 等工具原生入口,但还没有像 Gemini 那样的打包扩展形态。Nowledge 对 Codex 的推荐路径,是提示词加项目级 AGENTS.md 指导,底层直接使用 nmem。
这个集成保持得很简单:安装可复用提示词,按需合并项目 AGENTS.md,然后让 nmem 统一负责本地与远程记忆操作。
第一次成功应该看到什么
当 Codex 里已经能看到这些提示词、nmem status 能正常工作,而且你能成功完成一次记忆读取、搜索或真实会话保存时,这条路径就已经成立。
开始之前
- Nowledge Mem 已在本地运行(安装指南),或你已经有可访问的远程 Mem 服务
- 已安装 Codex CLI
nmemCLI 在你的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。
安装自定义提示词
curl -fsSL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-codex-prompts/install.sh | bash安装完成后,重启 Codex。
按需合并项目 AGENTS.md
如果你的项目已经有 AGENTS.md,请把 Nowledge 部分合并进去,而不是直接覆盖。
curl -O https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-codex-prompts/AGENTS.md需要远程 Mem 时,用更稳妥的方式配置
{
"apiUrl": "https://mem.example.com",
"apiKey": "nmem_your_key"
}nmem 的连接优先级如下:
--api-urlNMEM_API_URL/NMEM_API_KEY~/.nowledge-mem/config.json- 默认值
命令
在 Codex 对话里输入 /,搜索 memory、save、distill 或 search,或直接使用:
| 命令 | 功能 |
|---|---|
/prompts:read_working_memory | 读取当天的工作记忆简报 |
/prompts:search_memory | 回答前搜索 Nowledge Mem |
/prompts:save_session | 使用 nmem t save --from codex 保存真实 Codex 会话 |
/prompts:distill | 将高价值洞察提炼成记忆 |
为什么推荐这条路径
Codex 现在已经有多种工具原生接入路径:自定义提示词、项目 AGENTS.md、技能,以及 MCP。
对 Nowledge Mem 来说,推荐的 Codex 包仍然应该是一个工作流包,而不是伪造出来的“打包扩展”:
- 提示词提供清晰直接的入口
AGENTS.md提供项目级默认记忆行为,而且对用户可见nmem继续作为本地与远程记忆操作的唯一执行路径
这样更耐用,也更容易让用户理解整个系统到底是怎么工作的。
直接使用 nmem
常见例子:
nmem --json wm read
nmem --json m search "auth token rotation" --mode deep
nmem --json t save --from codex -p . -s "Finished the auth refactor and verified the new refresh-token flow."
nmem --json m add "JWT refresh failures came from gateway and API clock skew." --title "JWT refresh failures traced to clock skew" --importance 0.9 --unit-type learning -l auth -l backend -s codex