Agent Island：把 Claude Code / Codex 的会话状态塞进刘海儿屏
一个 macOS/Windows 原生状态栏工具，解决"AI 在跑，你不知道它跑完没"这个现实痛点。
核心观点
当你把一个长任务交给 Claude Code 或 Codex 跑后台，最难受的事不是等待本身，而是不知道它什么时候停 ------要么盯着终端浪费时间，要么错过了 turn 导致任务卡死一整晚。Agent Island 做的事就一件：把这个"不知道"变成"一眼就知道"，并在需要你接手时主动叫你。
这不是什么范式突破，而是一个工具链补全动作。Claude Code / Codex 本身已经能跑复杂 Agent 流程，但缺一个"状态感知外壳"------Agent Island 就是这个壳。参照系应该是类似 Bartender 或 iStatMenus 这类菜单栏工具，而非 AI 应用本身。
关键信息与机制
最聪明的那个点：读本地文件 + FSEvents，不是 API 轮询
Agent Island 的技术核心值得专门说一下。它不向 Claude/Codex 的服务端发请求来判断状态，而是：
- 直接读取 Claude Code、Claude Desktop、Codex 在本地磁盘上写的 transcript 文件；
- 用 macOS 的 FSEvents 监听这些文件的写入事件（Windows 端对应文件系统监听）；
- 解析特定的结束标记：Claude 的
stop_reason: end_turn，Codex 的task_complete。
这个设计的聪明之处在于：完全不依赖提供商 API 的实时性，延迟在 1 秒以内，而且天然本地、无需额外权限。代价是：它绑定了这两个工具的具体文件格式，一旦 Claude Code 或 Codex 改变 transcript 结构，检测就可能失效。
功能清单（按实用程度排序）
| 功能 | 实际价值 |
|---|---|
| 🔔 "轮到你"弹窗报警 | 最核心，后台任务跑完立刻叫人 |
| 🔴 红色脉冲 = 需要注意 | 识别限流、登录失效、网络错误 |
| 📊 用量 + 费用 + 重置倒计时 | Claude 显示 5 小时窗口和周用量 |
| 🏆 周/月报告卡 | 含 24 周热力图、七级 island rank |
| 🔁 一键重新验证 | Claude 登录过期时浏览器跳转完成，不用粘贴 token |
平台差异
- macOS：SwiftUI，刘海儿 MacBook 有宽版，老 Mac 有紧凑版，通用二进制
- Windows：WPF，顶栏或可拖拽浮窗，托盘图标常驻显示用量环
对比历史脉络
Agent Island fork 自 codex-island （Eric Park 作），后者是一个纯被动用量计：只看"用了多少"。Agent Island 在此基础上加了主动感知：会话状态动画 + 转向报警。这是一个典型的"功能跃迁"而非竞品替代------两者其实可以用同一个比喻：codex-island 是油表，Agent Island 是加了仪表盘和蜂鸣器的整个驾驶舱。
同类竞品方面，搜索中发现了两个值得对比的项目：
- Agent Signal Bar （guan-ops）：同样是本地优先，用红黄绿三色信号灯显示状态，macOS 专属，Apache 2.0，Swift 实现，支持 7 种细粒度状态（Thinking / Working / Done / Permission / Blocked 等），且有 CLI 工具可以接入自定义 Agent。监控逻辑上比 Agent Island 粒度更细，但不支持 Windows，也没有费用追踪和报告卡功能。
- claude-code-monitor / claude_monitor（PyPI、GitHub 多个独立作者）：Python 实现，走 hooks 系统，重点在 token 用量可视化和 Web Dashboard，不提供系统级弹窗报警，更适合"事后复盘"而非"实时感知"。
一句话总结：Agent Island 在跨平台覆盖 + 费用感知 + 主动报警 这条轴上最完整；Agent Signal Bar 在状态粒度 + 可扩展性 上更细腻；Python 系工具在历史分析上更好用。
交叉验证
搜索到两个独立信源，结论如下：
信源一：HelloGitHub 社区推荐 Issue（#3413，2026-07-05）
HelloGitHub 是有一定影响力的中文开源推荐平台，此 issue 由作者本人提交，被接受收录。描述与原文一致，确认了本地优先、无遥测、Homebrew 安装等关键信息。认同原文，但该页面缺乏第三方用户使用反馈，无法从"真实用户体验"角度独立验证。
信源二：Agent Signal Bar（guan-ops，GitHub，2026-06-02）
这是一个完全独立的竞品项目，侧面印证了**"需要一个 AI Agent 状态监控工具"这个需求的真实性**。其实现路径（本地文件读取、无服务端依赖）与 Agent Island 高度一致，说明原文的技术选型并非标新立异，而是当前这类工具的合理收敛方向。Agent Signal Bar 的存在还说明：这个赛道已经开始出现差异化竞争，不是 Agent Island 一家独有的局面。
补充信息 ：搜索到的另一个细节------80aj.com 报道了同期出现的 claudeTraffic 工具（macOS 菜单栏，灵感来自 V2EX），进一步确认这类工具在 2026 年上半年呈现集中爆发态势，背景是 Claude Code 和 Codex 的用户量快速增长。
边界与局限（不唱赞歌）
以下几点原文没有直说，但值得注意：
-
未过 Apple 公证（Notarized）：原因是没有付费 Apple Developer 账号。这不是安全问题，但对企业设备或有安全策略的 Mac 可能有障碍。Sparkle 自动更新走 EdDSA 签名验证，这部分有独立保障。
-
文件格式绑定风险 ：依赖
stop_reason: end_turn等字段，Anthropic 或 OpenAI 若调整 transcript 格式，检测会静默失效。项目维护者需要跟进上游变动。 -
Windows 功能不对等：原文语气是"same product, same detection engine"，但 Windows 用 WPF 实现，macOS 用 SwiftUI，两套 UI 框架长期维护成本不低，功能对齐程度存疑。周报卡等新功能是否同步到 Windows 版需要实际验证。
-
macOS 13+ 门槛：对于还在用 Monterey 以下系统的老机器不支持（实际上 13 = Ventura，覆盖面已经很广，但仍是边界）。
-
未过公正第三方测试：目前公开评价主要来自作者自述和社区推荐，缺乏独立的实际测试报告。
个人启发
对个人开发者：如果你有"挂着 Claude Code 跑任务，然后去做别的事"这个习惯，Agent Island 能直接替代"定期切回终端看看"这个低效动作。装上 Homebrew 一行命令，成本为零，值得试。
对团队 / 决策者 ：这类工具的出现说明 AI Coding Agent 已经进入"异步协作"阶段------人不再需要实时守着 AI，而是需要异步感知 AI 的状态。这对工程效率工具链提出了新要求，可以关注这个方向上的工具演进。
对工具开发者：Agent Island 的技术路线（FSEvents + 本地 transcript 解析）是一个值得借鉴的低侵入模式------不需要改 Claude Code 本身，不需要装 hooks，天然本地。Agent Signal Bar 走 hooks 路线粒度更细，但侵入性更高，两种路线各有适用场景。
延伸思考
-
Claude Code 的 transcript 文件是否应该有标准格式？ 目前多个独立工具（Agent Island、Agent Signal Bar、claude-monitor）都在解析这些文件，但没有官方 schema。Anthropic 若开放一个标准的 hooks 事件协议（类似 LSP 对编辑器的作用），生态会更健康，也能降低工具维护成本。
-
"AI Agent 伴侣工具"会走向集成还是碎片化？ 目前菜单栏工具、PyPI 监控包、Web Dashboard 各自为战，未来是否会有一个"一站式 AI Agent 工作台"整合这些能力？还是像 Alfred / Raycast 这样由效率工具平台吸收？
-
本地文件感知这个模式的天花板在哪？ 当 AI Agent 跨机器、跨平台、在云端容器里运行时，读本地文件的检测方式会完全失效。那时候需要的是服务端推送事件流（类似 WebSocket 或 SSE），Agent Island 目前的架构在"云端 Agent"场景下能否演进，值得观察。
工具地址 ：
brew install tristan666666/tap/agentisland/ GitHub / agent-island.dev竞品参考 ：Agent Signal Bar（状态粒度更细，仅 macOS）
📚 参考来源