agent-hud-open - 把 AI 编程代理的运行状态搬到屏幕、手机与手表上

agent-hud-open 是一个面向 AI 编程代理的桌面状态面板（HUD）开源项目，由维护者 jazzenchen 发布，采用 Apache-2.0 许可。它要解决的问题很具体：当 Claude Code、Codex 这类代理在后台持续工作时，用户往往在写代码、读文档或处理别的事情，无法随时知道哪个代理还在忙、哪个已经完成、哪个正卡在等待批准的一步。据项目自述，Agent HUD 把这些信息集中到屏幕边缘，让用户一眼看清状态，并可就地批准或拒绝请求；离开电脑后，还能通过 iPhone 与 Apple Watch 继续跟进。它适合日常同时驱动多个编程代理的开发者，尤其是以 macOS 为主要工作环境、希望减少在终端与窗口之间来回切换的人。

维护者与状态

项目仓库为 jazzenchen/agent-hud-open，维护者是 jazzenchen。仓库创建于 2026-10-22，最后一次提交在 2026-11-12。最新正式版本为 v0.6.0，发布于 2026-11-06。截至 2026-11-12，仓库获得 399 个星标。项目另有一个官网 agenthud.app，用于承载文档与下载入口。

从时间线看，这是一个相当年轻的项目：创建到最近一次提交不足一个月，已经迭代到 v0.6.0，说明维护节奏较快。读者在评估时应注意版本号仍处于 0.x 阶段，接口与行为可能随版本变化。

主要能力

以下能力均据项目 README 自述整理，未经过独立验证。

• 屏幕边缘状态显示。 项目提供两种模式：有刘海的屏幕默认使用 Notch 模式，光效环绕刘海；其他屏幕使用 Simple 模式，在任意屏幕边缘显示一个浮动小面板，每个代理的图标嵌在其最常用配额的圆环中，旁边标注百分比。代理工作时，图标会变成对应的小机器人形象。
• 配额与用量提示。 每个代理用一种颜色表示其最常用配额的消耗程度：低于 70% 为绿色，70% 起为黄色，90% 起为红色，并在配额耗尽前给出警告；代理工作时颜色流动更快。悬停可查看配额重置时间或消耗速率、余额、最近 24 小时的 token 用量以及会话列表，等待用户处理的会话排在前面。
• 就地处理请求。 用户可以在 HUD 上批准、拒绝或始终允许请求，并回答代理提出的问题，包括 Claude 桌面应用中的提问。项目说明强调它不会替用户做决定：未被处理的请求会在 10 分钟后退回给代理。
• 一键跳回会话。 点击即可跳转到对应会话的线程、标签页或终端面板。
• 手机与手表远程。 据项目说明，Agent HUD Remote 通过用户自己的 iCloud 同步，在 iPhone 上可查看进度、阅读回复并继续对话，在代理遇到只有用户能决定的问题时展示上下文并接受回答或批准；Apple Watch 支持用语音把想法直接发送到家里的 Mac，并在手表上阅读最新回复，再转到 iPhone 继续讨论。该远程功能仅限 macOS。
• 内置 MCP 服务器。 项目自述内置 MCP 服务，为代理之间提供通信通道，也提供构建自定义界面的工具。代理之间可以互相发消息，例如 Claude Code 完成改动后请 Codex 会话审查并取回答复，或新建会话交接任务；据说明，Claude Code、Codex、Antigravity 与 DeepSeek Harness 之间可以互发消息或新建会话，消息会等待目标会话空闲后再送达，不打断当前回合。用户也可以让代理通过 MCP 调整 HUD 的布局与外观，改动先以预览呈现，按下保存后才生效。
• 用量统计。 项目提供 token 用量与成本视角，可按今天、最近 7/30/90 天或一年查看，区分输入、输出、推理、缓存写入与缓存读取，并按代理、模型、会话、回合与调用维度拆分，另有缓存命中、活动热力图、配额填充情况与余额等视图。项目说明称 token 数据保留在用户电脑上，手机端保留 30 天；成本按各厂商标价估算，标注为约数，并非实际扣费。
• 资源占用。 README 给出了一组在 Apple M1 Max、macOS 26、约 8000 份会话日志条件下的测量值：空闲时 CPU 约占单核 7%，内存约 240 MB，8 小时能耗约 0.1 Wh；忙碌时 CPU 为 7%–28%，内存 240–260 MB，能耗 0.1–2.3 Wh。这些数字来自项目自述，本站未复现。

使用入口

源码与版本发布位于 jazzenchen/agent-hud-open，产品介绍与文档见 agenthud.app。

据 README，macOS 上可通过 Homebrew 安装：

brew install --cask jazzenchen/tap/agent-hud

在 macOS、Windows 或 Linux 上也可通过 Node.js 安装：

npx @agenthud/install

项目说明称，两种方式都会安装最新版本（包含 beta），macOS 上安装后会自动更新；若应用已存在于 /Applications，需在 Homebrew 命令后加 --adopt。此外也可以直接下载 release 包。

许可与限制

许可证为 Apache-2.0。使用前需要了解的边界条件，据项目自述包括：

• 平台支持方面，macOS 为当前正式支持平台；Windows 与 Linux 处于预览状态，虽可从同一份源码构建，但尚未在真实机器上验证。
• iPhone 与 Apple Watch 需与 Mac 配对，远程功能通过 iCloud 同步，因此仅在 macOS 上可用。
• 成本数字是按厂商标价估算的约数，不代表实际账单。
• 代理间消息只传递代理写出的内容，不传递整个会话；同一项目下以项目本身作为共享上下文。
• 未处理的批准请求会在 10 分钟后退回代理，不会无限期挂起。
• 项目处于 0.x 版本阶段，功能与行为可能随版本调整。