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 会把它换掉。

第一次用？请看 开始使用。