BRAIN.mdv0.3.0

Codex 会话快照与优先使用 MCP 的接线规则

Codex 现在也能像 Claude Code 一样选择启用 SessionStart 快照，接线文件在检测到已认证的 brain MCP 时会优先使用它。

亮点

接线规则：优先 MCP，回退 CLI

brain wire / brain init 现在会把这条访问规则写进 AGENTS.md / CLAUDE.md：

不要手动编辑大脑文件。如果已连接并认证了 brain MCP 服务，优先使用它；否则使用 brain CLI。

标准做法仍然是基于 CLI 的。这只是加了一句话，让已经接入 brain MCP 的 Agent（例如 MindMux Cloud Brain）直接用它；其他项目行为不变。已有项目运行一次 brain wire 即可更新——只会替换标记过的 companion 区块。

brain install-hooks --agent codex

项目级的 Codex SessionStart 快照（启动、恢复、清空、压缩时触发），不会改变 Claude Code 的默认行为。

npx @mindmux/brain-md setup -y
npx @mindmux/brain-md init
npx @mindmux/brain-md install-hooks --agent codex

可用 brain uninstall-hooks --agent codex 撤销。两个命令都是幂等的。

  • 需要 Codex CLI 0.153.4+（更早的版本未经验证）。
  • 钩子只会调用 brain brain-dir 和 brain list-pages，从不读写大脑中的 Markdown 文件。
  • 大脑为空时自动跳过；任何失败都会以退出码 0 结束。Codex 对执行时间有 5 秒上限。
  • 只注入紧凑的页面列表（id / 标题 / 分类 / 状态），并截断为 8 KiB 的完整 UTF-8 行——不包含页面正文。
  • 生成的命令中包含绝对项目路径：移动项目前请先卸载，移动后再重新安装。

改进

  • 接线后的 Agent 文件现在会说明 brain 不在 PATH 上时如何调用随包附带的 Node CLI（node <brain-page-skill-dir>/bin/brain.mjs …）。

安装说明

  • 如果想直接使用 brain 命令，建议全局安装；只用 npx 不会把 brain 加到 PATH。
  • 已有安装：升级到 @mindmux/[email protected]，然后运行 brain setup -y。
  • 已经接过线的项目：在项目根目录运行 brain wire 刷新 companion 区块。

相关链接

分享到