Codex 跑完一轮，怎么知道
一轮结束时 Codex 会告诉某个东西。告诉什么，由你决定。
Codex 自己会做的
Codex 可以把完成的一轮交给你指定的程序，它还有一个在结束本轮之前运行的生命周期 hook。两者加起来，工作结束时你几乎能让任何事发生。
代价是得你自己写。一个脚本、一个通知器、一个声音——然后在每台工作的机器上再来一遍，事件形状变了还要再改一遍。
Agent HUD 在 Mac 上怎么提醒
灵动岛本身就是提醒，完全不用配置。一轮结束时显示会话标题和用时，然后收回去。通知中心里什么都不会留下，因为 Agent HUD 在 Mac 上不发系统通知。
它看的是 Codex 本来就在写的 rollout 日志，所以 Desktop 和 CLI 都会出现，一个会话即使归档也只计一次。
额度的事，在同一个地方
- 四件事各提醒一次：越过已用 90%、用尽归零、预计撑不到重置、以及一次确认的重置。
- 启动后窗口的第一次读数是静默基线，所以启动时就已经在屏幕上的状态永远不会触发提醒。
- 超过 30 分钟的旧读数继续显示，但不触发任何东西。
- 暂停采集时、或上一次刷新失败时不会触发。
人不在 Mac 前面
Agent HUD Remote 把一台 Mac 的状态同步到免费的 iPhone、小组件与 Apple Watch 应用。在那边同样这些事件是真正的系统通知，进行中的会话以实时活动呈现，计时还在走。
常见问题
- 那我还要不要写 notify 程序？
- 如果你想让某件具体的事发生——发个 webhook、亮一盏灯、往某个频道发消息——那正是它的用处。但只是想知道一轮跑完了，灵动岛不用脚本就已经做到了。
- Agent HUD 需要装那个 hook 吗？
- 对 Codex 不需要。它读的是 Codex 本来就在写的 rollout 日志，不配置任何东西也能看到完成。
- Desktop 和 CLI 都会出现吗？
- 会。在同一个 Codex home 下它们共用账号，所以会话和窗口是合在一起出现，而不是两份。
- Agent HUD 会发 macOS 系统通知吗？
- 不会。在 Mac 上每一条提醒都是灵动岛。系统通知发生在 iPhone 和 Apple Watch 上，通过 Agent HUD Remote。
指南
最近更新： 2026-09-20 · 这里描述的行为，在 Agent HUD Open 的文档里有完整说明，并附有对应代码。 github.com/jazzenchen/agent-hud-open