Notchi – Claude Code および Codex のための macOS「ノッチ」コンパニオン

何であるか – MacBook Pro の画面のノッチに常駐する小さな macOS アプリで、Anthropic の Claude Code および OpenAI の Codex からリアルタイムで発生するイベントに応じてアニメーションするマスコットを表示します。また、送信したプロンプトの感情分析を行い、感情的な反応を表示する機能もオプションで利用可能です。

---

コア機能（README に記載）

機能	得られるもの
リアルタイムイベント反応	Notchi は Claude Code や Codex にシェルスクリプトのフックを登録します。モデルがイベント（思考、ツール使用、権限リクエスト、エラー、完了など）を発行すると、フックは Unix ソケット経由で JSON ペイロードを送信します。Notchi はペイロードを解析し、それに応じてマスコットをアニメーション化します。
感情に基づく感情表現	設定で Anthropic または OpenAI の API キーを貼り付けると、Notchi はそれぞれの API を呼び出してプロンプトの感情分析を行い、マスコットを喜び、悲しみ、喜びすぎ、中立、または「泣き崩れ」の表情で表示します。
使用状況の追跡	下部のバーに過去 30 日間の日次トークン使用量と推定コストを表示。プロバイダーごとまたは合計で表示。クリックすると、セッション時間、クォーターバー、コストチャートを含むダッシュボードが表示されます。
複数の同時セッション	各アクティブな Claude または Codex セッションごとに、独自のスプライト（Claude/Codex スプライトファミリーから選択）が、ノッチをクリックすると現れる小さな「芝生の島」に配置されます。
カスタムサウンド効果	各イベント用に内蔵されたサウンドあり。独自のサウンドもインポート可能。ターミナルウィンドウにフォーカスがあるときは自動的にミュートされます。
ローカライズ	UI はシステム言語に従い、英語、日本語、簡体字中国語、繁体字中国語、韓国語、ベトナム語に対応しています。
自動更新	Sparkle フレームワークを使用して、署名済み・ノタライズ済みの更新を提供します。
クロスプラットフォームコミュニティポート	コミュニティメンテナンスの Windows ポート（notchi‑for‑windows、pixel‑companion）へのリンクがあります。

---

インストール手順（README から）

1. リリースページから最新の DMG をダウンロード（例：Notchi‑1.2.7.dmg）。
2. DMG を開き、Notchi を アプリケーション フォルダにドラッグします。
3. アプリを起動 – 最初の起動時に Claude Code および/または Codex のフックを自動でインストールします。
4. macOS がキーチェーンへのアクセスを要求した場合（API 使用統計を保存するために使用）、常に許可 をクリックします。
5. （オプション）設定 → Anthropic または OpenAI の API キーを貼り付けて感情分析を有効化します。
6. Claude Code または Codex を通常通り使用。マスコットが反応し始めます。
7. 使用量バーをクリックしてコスト/使用状況ダッシュボードを表示します。

---

内部での動作（高レベルフロー、README から）

Claude Code / Codex  →  フックスクリプト（シェル）  →  Unix ソケット  →
イベントパーサー  →  状態機械  →  アニメーションスプライト

• フックスクリプトは Notchi によってインストールされ、AIエージェントが発行する JSON イベントをリッスンします。
• イベントはローカルの Unix ソケット経由で Notchi プロセスに送信されます。
• アプリは JSON を解析し、イベントからアニメーション状態（アイドル、作業中、睡眠中、コンパクティング中、待機中など）へのマッピングを行う有限状態機械を更新します。
• API キーが存在する場合、プロンプトテキストは Anthropic または OpenAI に送信され、感情分析が実行されます。その結果がマスコットの表情に影響を与えます。
• UI は適切なスプライトをノッチ領域に描画し、使用状況パネルを更新します。

---

要件と互換性

• macOS 15.0+（Sequoia） – このバージョンで導入されたノッチ UI に依存しています。
• 物理的なノッチを持つ MacBook – マスコットはその空間に存在します。
• Claude Code および/または OpenAI Codex がマシンにインストールされている必要があります。フックをアタッチするためです。

---

コントリビューションとサポート

• プルリクエストによる貢献を歓迎します。ガイドラインは CONTRIBUTING.md を参照してください。
• プロジェクトは GPL‑3.0 限定です。
• GitHub Sponsors で開発をスポンサードできます（署名ビルドに必要な Apple Developer アカウントの費用をカバー）。

---

一言で言うと

Notchi は、Claude Code と Codex の内部動作を遊び心ある方法で可視化する、実用的な macOS コンパニオンです。同時に、開発者がトークン使用量をリアルタイムで確認し、感情分析のフィードバックをオプションで受け取れるようにします。これは単なるチュートリアルやリストではなく、AIエージェントとのインタラクションに焦点を当てた本格的なソフトウェアプロジェクトです。