集成

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 专属规则——例如“绝不修改 *.note.md”、“新调研放 research/ 下,文件名带日期前缀”。
  3. 在 vault 目录运行 codex。它会自动捡起这些规则。
  4. 在 note.md 里审读它的产出;批注;告诉下一次运行去读伴生文件。

FAQ

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

不需要。vault 就是工作目录里的纯文件——Codex 的主场。MCP 端点是给分享 worker 用的(发布页面),基本的 vault 工作用不上。

AGENTS.md 里该禁止什么?

唯一的硬规矩:agent 不写你的 .note.md 伴生文件——那里存的是人的判断。其余(命名、目录、链接风格)都是各家的偏好。

拥有你的思考。

免费。开源。你 Mac 上的一个 markdown 文件夹。

下载 macOS 版