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 檢測進程存活狀態，並監控會話檔寫入時間以判斷活動狀態。