realfishsam/agent-notch

何を解決するか

Agent Notch は、macOS 上の AI エージェント（特に Claude Code と Codex）の視覚的ステータスインジケータを提供し、ターミナルウィンドウを開いたままにしなくても、エージェントが現在作業中か、アイドル状態か、タスクを完了したかを一目で確認できるようにします。

動作方法

このツールは、3秒ごとにシステムをポーリングするゼロ構成アプローチでエージェントの活動を検出します。claude または codex プロセスが TTY に接続されているかを識別し、ディスク上の対応するトランスクリプトファイルにマッピングします。

活動状態はハイブリッドチェックによって判断されます：プロセスが生存しており、かつトランスクリプトが過去30秒以内に更新されていれば、エージェントは「作業中」とマークされ、マスコットがMacBookのノッチの隣を歩きます。プロセスが2回のポーリングサイクルにわたって存在しなければ、「完了」とマークされ（緑のポップで示される）、クリック可能なパネルでセッションの詳細を確認できます。セッションはユーザーの最新のプロンプトごとにグループ化され、サブエージェントはドロップダウンで整理されています。

対象ユーザー

ターミナルで Claude Code や Codex などの AI エージェントを実行している macOS ユーザーで、OS のどこからでも複数のエージェントセッションとその進行状況を、邪魔にならない方法で監視したい人。

特徴

• ゼロ構成セットアップ：API、フック、アカウントの設定は不要。
• ノッチ統合：作業中の状態を示すマスコットが MacBook のノッチの隣を歩く。
• セッション管理：透過的でクリック可能なパネルで、アクティブなセッション、使用中のモデル、サブエージェントの階層を表示。
• カスタムマスコット対応：さまざまな公式 Codex Pets スプライトシートをサポート。
• 低負荷：ps と lsof を使ってプロセスの生存確認を行い、トランスクリプトの書き込み時刻を監視して活動状態を判断。