このプロジェクトについて

PokeTokenBarは、トークン消費をポケモンの相棒に変えることでAIコーディングのトークン使用量をゲーム化するmacOSメニューバーアプリです。Claude Code、Codex、Gemini CLI、Antigravity、OpenCode、Hermes Agent、Cursor、Grok CLI、Copilot CLI、Kiro CLI、Pi Agent、omp、Asideの使用量をローカルログを直接読み取って追跡します—外部CLIは不要です。 **コアメカニクス:** - 🥚 **孵化**:消費したトークンが卵を温め、第1〜5世代のポケモン(329種類の開始候補)が孵化します。公式捕獲率で重み付けされ、伝説はレア(129分の1)。各孵化で25種類の性格のいずれかが抽選され、まれに✨色違いの可能性もあります。 - ⚡ **進化**:コーディングを続けると、実際の進化ツリー(1/2/3段階、分岐あり)を通じてポケモンが成長し、各段階でフラッシュ演出があります。 - 🎓 **卒業と収集**:最終形態+しきい値に達すると図鑑に永久保存され(レアなほど長くかかり、ヘビーユースでコモン約3日→伝説約24日)、新しい卵が届きます。 - 🍬 **ふしぎなアメ**:5時間または週間の使用上限を満たすとふしぎなアメを獲得でき、バッグから現在のポケモンを成長させるために使えます。 - 🛒 **ショップ**:使用済みトークンを通貨として、ふしぎなアメ、ミント(性格再抽選)、色違いのお守り(色違い確率を永続的に上昇)、卵(ポケモンのタマゴ、アンコモンのタマゴ、レアのタマゴ)を購入してやり直せます。 **機能:** - **メニューバー**:今日の合計トークン(`200.7M`のようなコンパクト形式)の隣に第V世代のアニメスプライトを表示。コストや上限パーセント表示も任意で可能。 - **フローティングデスクトップペット**:相棒を任意のサイズ(48〜384px)でデスクトップに移動でき、ホバーでの吹き出し、クリックで開く、右クリックメニュー、吹き出しでの上限アラートに対応。 - **図鑑と捕獲ログ**:種ごとに1セル(1ページ24件、図鑑番号順、色違いは✨)、さらに完全な進化ライン、レア度、性格、捕獲日を含む捕獲ログ。 - **公式上限**:Claude、Codex、Antigravityの5時間/週間使用率をリセットまでのカウントダウンと消費速度予測付きで追跡。 - **モデル別内訳**:複数モデルが同じセッションログを共有する場合、Pi Agentの使用量を実際のモデルIDに帰属。 - **設定**:メニューバー項目、更新間隔(1〜15分または手動)、ログイン時に起動、Keychainのオプトアウト、しきい値付き上限アラート、相棒の通知、完全なKO/EN/JA/ES/FR/PT/DEのUIとポケモン名。 - **成長難易度**:しきい値とショップ価格を10%〜200%で調整可能。すでに卒業したラインからの孵化は2倍速く成長。 - **日別チャート**:日ごとのトークン(およびコスト)を示すコンパクトな月間チャート。 - **追加スキャンフォルダ**:組み込みパス外のログを指定可能(プロバイダーごと、ワイルドカード対応)。 - **claude.aiセッションキー**:Keychainアクセスなしで公式上限を使うための任意の貼り付け。 - **低電力モード**:メニューバーのアニメーションは省電力品質で継続。 - **アプリ内アップデート**:ワンクリックのアップデート確認。 **対応ツールと追跡:** | ツール | 追跡 | 公式上限 | |---|---|---| | Claude Code | 今日 · 5時間ブロック · 週 · 月 | ✅ 5時間 / 週間 | | Codex | 今日 · 週 · 月 | ✅ 5時間 / 週間 | | Gemini CLI | 今日 · 週 · 月 | — | | Antigravity | 今日 · 5時間ブロック · 週 · 月 | ✅ 5時間 / 週間 | | OpenCode | 今日 · 5時間ブロック · 週 · 月 | — | | Hermes Agent | 今日 · 5時間ブロック · 週 · 月 | — | | Cursor | 今日 · 5時間ブロック · 週 · 月 | — | | Grok CLI | 今日 · 5時間ブロック · 週 · 月 | — | | Copilot CLI | 今日 · 5時間ブロック · 週 · 月 | — | | Kiro CLI | 今日 · 5時間ブロック · 週 · 月 | —(推定) | | Pi Agent | 今日 · 5時間ブロック · 週 · 月 | — | | omp (oh-my-pi) | 今日 · 5時間ブロック · 週 · 月 | — | | Aside | 今日 · 5時間ブロック · 週 · 月 | — | **データソース:**各ツールの標準パスからローカルログ(JSONL、SQLiteなど)を読み取り、さらに種/進化データとスプライト用にPokéAPIを使用(実行時に取得し、ローカルにキャッシュ)。公式上限は非公式エンドポイント(Anthropic、codex app-server、Antigravity Google APIs)を使用し、Keychainアクセスは手動更新時のみ。 **プライバシー:**オンデバイス優先—使用量のアップロードはありません。外部リクエストは12のホスト(PokéAPI、GitHubスプライト、Anthropic、claude.ai、cursor.com、Google APIs、ステータスページ、GitHubアップデート確認)に送信されますが、使用ログ、プロンプト、プロジェクトパスは決して含まれません。Keychainは任意で、手動更新時のみ読み取られます。 **インストール:**macOS 14+(Apple SiliconまたはIntel)。Homebrew cask(`brew install --cask chattymin/tap/poke-token-bar`)、手動zipダウンロード、またはSwift 6でソースからビルド。アドホック/自己署名のため、初回起動時にGatekeeper警告が表示されます(右クリック→開く、または`xattr -dr com.apple.quarantine`で解除)。 **ライセンス:**MIT(オリジナルのソースコードのみを対象。ポケモンのアセットは同梱されず、実行時に取得)。非公式の非商用ポケモンファンプロジェクトです。