集成

note.md + Codex

Codex 让 AGENTS.md 流行起来——一个纯文本文件,告诉 agent 这个文件夹怎么运转。note.md 的 vault 正是一个规则写在 AGENTS.md 里的文件夹。你能猜到接下来的剧情。

为什么这对组合成立

Codex 从运行目录读取 AGENTS.md——这是它的原生惯例,零配置。note.md 的 vault 把文件规则(sidecar 文件配对、大纲格式、日期链接、块级引用)恰好发布在这个文件里。所以集成就是:cd vault && codex。完事。

Codex 最强的角色是干活的 agent:让它起草、重构文档、批量处理笔记,或者写 vault 里日积月累的小脚本(导入器、链接检查器、报告生成器)。它写的一切都是 vault 里的 markdown,也就意味着它写的一切都会流进你的阅读-批注循环。

配置

  1. 把 llms-full.txt 里的约定摘要复制进 vault 根目录的 AGENTS.md。
  2. 加上 vault 专属规则——例如“除 Smart Lookup fenced answer 外,把 *.note.md 视为人拥有”、“新调研放 research/ 下,文件名带日期前缀”。
  3. 在 vault 目录运行 codex。它会自动捡起这些规则。
  4. 在 note.md 里审读它的产出;批注;告诉下一次运行去读sidecar 文件。

FAQ

Codex 需要 MCP 服务器才能用 vault 吗?

不需要。vault 就是工作目录里的纯文件——Codex 的主场。若更适合工具接口,已发布的本地只读 Vault MCP 提供 search 与 vault_info;分享 Worker 的 MCP 是另一套发布接口。

AGENTS.md 里该禁止什么?

把 .note.md 视为人拥有。Smart Lookup 的 fenced answer 回写是唯一狭窄例外;普通 agent 不应改高亮、问题或已采纳结论。其余(命名、目录、链接风格)都是各家的偏好。

拥有你的思考。

免费。开源。你自己电脑上的一个 markdown 文件夹。

下载 note.md