ericjypark/codex-island

解決する課題

CodexIslandは、Claude CodeとCodexのAI使用制限をリアルタイムで追跡できるmacOSネイティブのオーバーレイです。プロバイダーごとに手動でクォータを確認する手間を省き、これらの指標をMacBookのノッチ（またはメニューバー）に直接統合することで、常に低負荷で可視化します。

仕組み

このアプリはローカルファーストのオーバーレイとして動作します。Claude CodeやCodexのコマンドラインツール（~/.codex/auth.jsonやmacOS Keychainなど）から既存の認証情報を読み取り、各プロバイダーの利用状況エンドポイントを呼び出します。認証情報自体は保存しませんが、ローカルのSQLiteデータベースを保持し、トークン数や利用履歴を長期的に追跡します。

対象ユーザー

Claude CodeやCodexのパワーユーザーや開発者向け。5時間および週単位の使用枠を監視し、ローカルログに基づいてAPIコストを推定し、macOS上で長期的なAI利用パターンを可視化したい方に最適です。

主な特徴

• ノッチネイティブデザイン: ハードウェアのノッチに合わせたDynamic Islandスタイルのオーバーレイ。ノッチのないディスプレイ用のフォールバックも用意。
• マルチプロバイダー追跡: ClaudeとCodexの両方の使用状況を5時間および7日間のウィンドウで監視。
• コスト推定: Claude Code、Codex CLI、OpenCodeのローカルセッションログを使用して、推定支出とトークン消費量を計算。
• 利用状況の可視化: 年間アクティビティを表示するコントリビューションスタイルのカレンダーや、累積グラフ付きの共有可能な利用カードを搭載。
• プライバシー重視: テレメトリ、クラッシュレポート、プロキシサービスは一切なし。すべての集計とレンダリングはデバイス上で行われます。
• カスタマイズ可能なアラート: 制限に近づいた際にアイランドの色を変える、警告およびクリティカルしきい値の設定が可能。