amenbo 4.0.0 — 可以讓您的 AI 每次開場都先看 amenbo

這個版本改的是 AI 在一個資料夾裡最初怎麼知道 amenbo，並且把外掛畫面重排成依專案一列。升級前請讀更新那一節。

可以讓您的 AI 每次開場都先看 amenbo

在此之前，告訴 AI 在一個資料夾裡怎麼跟 amenbo 打交道的，只有放在 CLAUDE.md 或 AGENTS.md 裡的文字。AI 讀不讀由它自己決定，而沒讀就做的工作，哪裡都沒有紀錄。AI 工具有工作階段開始掛鉤——每次開一個工作階段就跑固定動作的機制——amenbo 現在會把設定遞給您，讓自己進到那裡。

• amenbo agent-hook snippet claude-code 會印出那段文字與它該放的位置——支援五種工具：Claude Code、GitHub Copilot CLI、Cursor、Codex CLI、Gemini CLI。
• amenbo 絕不去寫工具的設定檔——它印出來的是一段寫給您所用 AI 的委託。您把那段文字遞過去，由 AI 來改檔案；委託裡會請它保留既有內容，只做追加。
• 沒有設定的資料夾會說出來，並點出是哪個工具——amenbo 從資料夾裡留下的痕跡判斷您用的是哪個工具。

$ amenbo status
⚠ One step is left before your AI keeps this work in amenbo: Claude Code's settings here do not open a session with `amenbo agent`.
  The text to give your AI: amenbo agent-hook snippet claude-code

設定到位之後，這個提示就停了。如果您不想要，跑 amenbo agent-hook answer no 指令，它就不再問——那段文字隨時還能從 snippet 指令拿到。GUI 也一樣：打開資料夾時問您一次，按下「把文字給我」就顯示出來。在沒有任何工具痕跡的資料夾裡，您從五個裡面挑。

外掛的開關與設定排在同一列

• 一個專案一列——外掛畫面現在是一個專案一列。「新增專案…」加一列，開關這個外掛的開關就在那一列裡。
• 設定在列內展開——按下「設定」，那個專案的設定就在它下面打開，沒有什麼要重新挑的。
• 必填項是空的，不用您按什麼就看得出來——那一列會寫著「必填設定未填寫」。填好之後它變成「設定已填寫」，外掛就能打開了。
• 專案自己的設定裡也到得了同一列——專案設定畫面有一個「外掛」區塊，在那裡加的列帶著同樣的開關與設定。

等著的通知可以推出去

給外掛的通知，通常搭著您當下那次寫入一起走。中途停下的東西會等下一次寫入，所以您的工作一有空檔，它就可能一直沒被送出去。跑新加的 amenbo plugin flush 指令，就能把等著的現在送出去。

$ amenbo plugin flush
Nothing was waiting: every plugin's queue is empty.

一些小事

• amenbo task show 開頭就寫狀態——五種（待辦 / 進行中 / 受阻 / 完成 / 已否決）裡的哪一種。它以前只說這個任務完成了沒有。
• show 會數評論並給出預覽——任務與決定紀錄都一樣。
• 回頭讀 amenbo 的外掛不會再中途停下——外掛在收到事件之後回頭問 amenbo 這件事，以前會出錯失敗。
• 評論通知會寫出這則評論所在的任務——接收的一方能知道它講的是什麼。

更新之前

• 儲存的資料格式往上抬——更新的版本第一次打開它時會自動遷移，遷移前先做備份。之後更舊的版本就打不開了，所以別把 GUI 或 CLI 留在舊版本上（同一個安裝程式會更新兩邊）。
• dimension rename 與 dimension value-rename 不見了——要給維度改名，跑 amenbo dimension update <dimension> --name <new name> 指令；給值改名是 amenbo dimension value-update <dimension> <value> --name <new name>。

取得方式

請到 最新版本 打開您所用作業系統的安裝程式。不需要管理者權限。

• macOS——.pkg，Apple 晶片與 Intel 各一個（GUI 與 CLI 裝在一起；第一次打開會出現 Gatekeeper 提示：按右鍵 →「打開」）
• Windows——setup .exe（GUI 與 CLI 裝在一起）
• Linux——GUI 是 AppImage；amenbo 指令來自 CLI 的安裝程式

要更新時：在 GUI 上，「有更新版本可用」的橫幅會就地完成更新。如果您只裝了 CLI，amenbo update --apply 會把它換掉。

第一次用嗎？請看 開始使用。