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

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