amenbo 6.0.0 — 建立專案要連著資料夾一起

AI 是透過資料夾構到專案的，所以沒有資料夾的專案，從哪裡都操作不了。現在建立專案一定會問資料夾，而落到沒有資料夾的專案會說出來。升級前請讀更新那一節。

建立專案要連著資料夾一起

amenbo project add 現在需要 --dir。

$ amenbo project add --name Greenhouse --actor human
error: the following required arguments were not provided:
  --dir <DIR>

$ amenbo project add --name Greenhouse --dir /work/greenhouse --actor human
✓ Created project: Greenhouse (1) — linked to /work/greenhouse

畫面上也一樣——新增專案畫面有一個資料夾欄位，沒挑資料夾之前「建立」按不下去。

最後一個資料夾現在可以解除連結

以前必須留下一個資料夾。現在它可以被移除，而回覆會說這樣一來您手上剩下什麼。

$ amenbo unbind --actor human --yes
✓ Unbound /work/greenhouse (removed: .amenbo, AGENTS.md, CLAUDE.md). The project is kept.
  This project now has no folder. An AI reaches a project through a folder, so nothing can
  operate it until one is linked again (`amenbo bind --project <name or ID>`).

沒有資料夾的專案會在兩個地方被回報

免得它被忘掉。

• 在專案的看板上——This project has no folder linked，旁邊有一個 Link a folder 的動作。看板自己的卡片還在它下面立著。
• 在 amenbo doctor 裡——而且如果您已經不做那個專案了，amenbo project archive 就是重新連結資料夾之外的另一條路。已封存的專案不會被要資料夾。

$ amenbo doctor --actor human
doctor: 1 issue(s) (error 0 / warning 1)
  [warning] project_without_folder (1):
    Project #1 'Greenhouse' has no folder on this machine leading to it: there is nowhere to
    operate it from, and an AI cannot reach it at all.

AI 不從 amenbo 開場的資料夾，也會被回報

一個資料夾可以已經連結好，卻在 AI 工具自己的設定裡沒有 amenbo 的接線，那樣 AI 就會一路工作而從不問 amenbo。amenbo doctor 現在會把這些挑出來。

$ amenbo doctor --actor human
doctor: 1 issue(s) (error 0 / warning 1)
  [warning] unwired_folder_ambiguous (1):
    /work/worker does not start its AI on amenbo, and shows no sign of which tool is used
    there, so nothing can say which wiring is missing.

• amenbo agent-hook snippet <tool> 印出要遞給在那個資料夾裡跑的 AI 的文字——amenbo 絕不替您去改那些設定檔。
• 同樣的清單也出現在專案自己的設定畫面裡。

一些小事

• 看板上只留一則常駐提示——以前可以疊起好幾則。

更新之前

• 儲存的資料格式往上抬——更新的版本第一次打開它時會自動遷移，遷移前先做備份。之後更舊的版本就打不開了，所以別把 GUI 或 CLI 留在舊版本上（同一個安裝程式會更新兩邊）。
• 給每一個 amenbo project add 加上 --dir——在您自己的指令稿裡，也在您遞給 AI 的指示裡。

取得方式

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

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

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

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