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 區塊。

相關連結

分享到