Javis603/token-monitor

Local-first desktop widget for tracking token usage, costs, and limits across 36+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, and OpenClaw—with multi-device sync.

Token Monitor – これは何ですか

Token Monitor は、数十種類のAI駆動型コーディングアシスタント（Claude Code、GitHub Copilot、Cursorなど）のトークン消費量とクォータ制限を監視するクロスプラットフォームデスクトップウィジェットです。各ツールのローカルログやAPIキー残高を読み取り、データを集約してカスタマイズ可能なダッシュボードでリアルタイムの数値を表示します。このアプリは複数のマシン間でその要約を同期できるため、常に一貫した最新のAI利用状況を確認できます。

コア機能（READMEに記載）

機能	動作方法	表示内容
リアルタイムトークン追跡	35以上の対応ツールのローカルトランスクリプトファイル、SQLiteデータベース、またはAPIキー残高エンドポイントを読み取ります。	AIの各ターン後に数秒以内にトークン数が更新されます。
セッションごとの詳細分析	特定のセッション（例：Claude Codeのトランスクリプト）を開き、プロンプト/応答のトークン分割を解析します。	入力トークンと出力トークンの詳細、キャッシュヒット/ミス、使用されたモデルの情報が表示されます。
コスト表示	組み込みの価格表（または手動で入力したサブスクリプション情報）を使用して、トークンをUSD、TWD、HKD、CNYに変換します。	トークン数と金額が横並びに表示され、為替レートは毎日更新されます。
クォータ/制限監視	ローカルエクスポートまたはAPIキーのエンドポイント（OpenRouter、Minimaxなど）から、プロバイダー固有の制限（日次、週次、課金期間）を照会します。	視覚的なクォータバー、満杯率インジケータ、制限に近づいた際にアラートが表示されます。
歴史的傾向とヒートマップ	日次集計をローカルに保存（ソースファイル削除後にアーカイブも可能）。	1年分のヒートマップ、ストリークカウンター、ツールまたはモデルごとの積み上げ棒グラフ/K線チャート。
マルチデバイス同期	デバイスの利用状況のコンパクトな要約をハブ（ウィジェット内ホスト、セルフホストNode、Cloudflare Worker）に送信。他のデバイスはServer-Sent Eventsで更新を受信。	すべてのマシンで同じリアルタイム数値を表示可能。iOSウィジェットも同じハブから取得可能。
エクスポート	必要に応じて、またはスケジュールに従ってトークン利用状況をCSV/JSONに書き出します。	スプレッドシート、Grafana、Obsidian、カスタムスクリプトなどに簡単にインポート可能。
カスタムUI	メニューバー（macOS）/システムトレイ（Windows）ポップオーバー、フローティングバブル、macOSネイティブウィジェットプレビュー、テーマ・透明度コントロール、ドラッグアンドドロップレイアウトコンポーザー。	ワークフローに合った外観を選択可能。ショートカット、Discord Rich Presenceなどを追加可能。

対応ツール（抜粋）

Claude Code, Codex, OpenCode, Hermes Agent, OpenClaw, Cursor, Antigravity, Kimi, Qwen, Grok Build, GitHub Copilot, Pi, Zed, Kilo, Command Code, MiMo Code, ZCode, Kiro, CodeBuddy, WorkBuddy, Proma, Qoder CN, Reasonix, DeepSeek, Cherry Studio, LM Studio, Unsloth, OpenRouter, Minimax, Volcengine, Ollama, Trae CN, Alibaba Cloud、およびNew API残高形式に準拠する任意のサードパーティAPI。

インストールと初回起動

macOS – brew install --cask token-monitor（Apple SiliconまたはIntel dmg）。
Windows – 署名済みの .exe（インストーラまたはポータブル版）をダウンロード。
Linux – AppImage（x64）を入手。
アプリを起動。自動的に対応ツールを検出し、ローカルオンリーモードで利用状況の追跡を開始します。

マルチデバイス同期オプション

ウィジェット内にハブをホスト – 常にオンのマシンを1台選択し、生成されたLAN URL + シークレットを他のデバイスにコピー。
セルフホストNodeハブ – TOKEN_MONITOR_SECRET を設定後、ヘッドレスサーバーで npm run hub を実行。
Cloudflare Workerハブ – 1クリックデプロイボタン；各クライアントにワーカーURLとシークレットを貼り付け。上記3つはすべてServer-Sent Eventsを使用しており、接続されたすべてのウィジェットに数秒以内に更新が反映されます。

こんな方に役立ちます

多数のAIコーディングアシスタントを使用する開発者：トークン消費とクォータの枯渇を追跡したい方。
AIサービスの予算を共有するチーム：透明性とプライバシーを重視した利用状況の可視化が必要な方。
フリーランスや趣味でAIを使う人：リアルタイムのコスト表示で予期せぬ請求を回避したい方。
複数のコンピュータ（デスクトップ、ラップトップ、WSL、iPhone）で作業する人：マシンごとの監視ではなく、1つのダッシュボードで統合的に管理したい方。

プライバシーに関する注意事項

すべてのプロンプト/応答の内容はローカルマシン上に留まります。同期ハブに送信されるのは、集計されたトークン数、コスト、制限データのみです。ハブはセルフホスト、ウィジェット内実行、またはCloudflareにデプロイ可能で、データの送信先を完全に制御できます。

クイックスタートチェックリスト

OSに応じたアプリをインストール。
Token Monitorを起動 – 自動で対応ツールを検出し、リアルタイムの利用状況を表示を開始します。
（オプション）複数のデバイスがある場合は、同期ハブをセットアップ。
ダッシュボードのレイアウト、通貨、エクスポート設定をワークフローに合わせてカスタマイズ。
すべてのAIコーディングツールにおけるトークン消費とクォータの健全性をリアルタイムで確認しましょう。