realfishsam/agent-notch

解决的问题

Agent Notch 为 macOS 上的 AI 代理（特别是 Claude Code 和 Codex）提供视觉状态指示器，让用户无需保持终端窗口打开，即可一目了然地查看代理当前是正在工作、空闲，还是已完成任务。

工作原理

该工具采用零配置方式，每 3 秒轮询一次系统，通过检测是否存在与 TTY 关联的 claude 或 codex 进程，并将其映射到磁盘上的对应会话文件。

活动状态通过混合检查判断：如果进程仍在运行，且会话文件在过去 30 秒内有更新，则代理标记为「忙碌」，其吉祥物将出现在 MacBook 的 notch 旁边行走。如果进程在连续两次轮询中均消失，则标记为「完成」（以绿色圆点表示）。点击式面板可提供详细会话视图，按用户最新提示分组，子代理以折叠菜单形式组织。

适用人群

在终端中运行 Claude Code 或 Codex 等 AI 代理的 macOS 用户，希望以非侵入性方式从系统任意位置监控多个代理会话及其进度。

主要亮点

• 零配置设置：无需 API、钩子或账户。
• 与 notch 集成：视觉吉祥物在 MacBook notch 旁行走，表示正在工作。
• 会话管理：透明可点击的面板显示活跃会话、使用的模型及子代理层级结构。
• 可自定义吉祥物：支持多种官方 Codex Pets 精灵图集。
• 低开销：使用 ps 和 lsof 检测进程存活状态，并监控会话文件写入时间以判断活动状态。