Token Tracker

English · 简体中文 · 日本語 · 한국어 · Deutsch

AI に使ったコストを正確に把握 — すべての CLI を横断して

47 種類の AI コーディングツールからトークン数を自動収集し、ローカルで集計、美しいダッシュボードで本当のコスト推移を可視化します。クラウドアカウント不要、API キー不要、セットアップ不要 — コマンド 1 つで完了です。

⭐ TokenTracker が時間の節約に役立ったら、ぜひ GitHub でスターを付けてください — 他の開発者が見つけやすくなります。

⚡ クイックスタート

動作要件: Node.js 20+（CLI は macOS / Linux / Windows で動作します。ネイティブデスクトップアプリは macOS（メニューバー）、Windows（システムトレイ）、Linux（AppImage、トレイ）を提供します。Cursor のトークン読み取りは、利用可能であればシステムの sqlite3 CLI を使用し、対応する Node リリースでは node:sqlite にフォールバックします）。

npx tokentracker-cli

これだけです。初回実行で hook をインストールし、データを同期して、http://localhost:7680 でダッシュボードを開きます。

30 秒で手に入るもの:

• 📊 localhost:7680 のローカルダッシュボードで、使用トレンド、モデル別内訳、コスト分析が見える
• 🔌 インストール済みの対応 AI ツールすべてに対する hook を自動検出
• 🏠 ローカルファースト — ログをマシン上で直接解析。アカウントや API キーは不要です
• 🧩 オプション: 250+ の公開 Skill を閲覧して Claude · Codex · AStudio · Gemini · OpenCode · Hermes 間で同期できる Skills タブ

ネイティブのデスクトップアプリが欲しい?

• macOS — TokenTrackerBar.dmg をダウンロード → Applications にドラッグ。デスクトップウィジェット、メニューバーのステータスアイコン、WKWebView 上の同じダッシュボードを含みます。
• Windows — TokenTracker-Setup.exe をダウンロード → 管理者権限不要のユーザー単位インストーラーを実行。WebView2 上にダッシュボードを表示するシステムトレイアプリです。ポータブル版 zip はリリースページにあります。
• Linux — TokenTracker-linux-x86_64.AppImage をダウンロード → chmod +x して実行。WebKitGTK ウィンドウにダッシュボードを表示するトレイアプリです。GTK/WebKit を同梱しているため、比較的新しい glibc 以外にディストリ側の依存はありません。GNOME ではトレイアイコンに AppIndicator 拡張機能が必要です。.deb と .rpm パッケージもリリースページにあり、こちらはディストリの webkit2gtk-4.1、gtk3、appindicator を利用します。.deb は libappindicator3-1 に依存しますが、Debian 12 はこれを廃止して libayatana-appindicator3-1 を提供しているため、Debian 12 では AppImage を使ってください。

短いコマンドで使うためグローバルインストール:

npm i -g tokentracker-cli

tokentracker              # ダッシュボードを開く
tokentracker sync         # 手動同期
tokentracker status       # hook の状態を確認
tokentracker doctor       # ヘルスチェック

🍺 Homebrew (macOS)

brew 派なら、追加の tap 操作なしで直接インストールできます:

# macOS メニューバーアプリ (DMG)
brew install --cask xiufengsun/tokentracker/tokentracker

# CLI のみ
brew install xiufengsun/tokentracker/tokentracker

アップグレードは brew upgrade --cask xiufengsun/tokentracker/tokentracker。tap は新リリースから 1 時間以内に自動更新されます。

✨ 機能

• 🔌 47 種類の AI ツールを標準対応 — Claude Code、Codex CLI、AStudio、Cursor、Gemini CLI、Antigravity、Kiro、OpenCode、OpenSquilla、OpenClaw、Every Code、Hermes Agent、GitHub Copilot、Kimi Code、CodeBuddy、WorkBuddy、Grok Build、oh-my-pi、OmO、pi、Dots、Prime Agent、Craft Agents、Reasonix、Muse Code、Kilo CLI、Kilo Code、Roo Code、Zed Agent、Goose、Droid、Mimo Code、DuMate、ZCode、Qoder、AnythingLLM Desktop、Claude Science、DeepSeek Harness、TRAE Work CN、LM Studio、Unsloth Studio、Devin CLI、Cline、MiniMax Code、Command Code、TRAE
• 🏠 ローカルファースト — すべてマシン上で動作。アカウントや API キーなしでログをローカル解析します。
• 🚀 ゼロコンフィグ — Hook は初回実行で自動インストール。0 からダッシュボードまで 30 秒。
• 📊 美しいダッシュボード — 使用トレンド、モデル別コスト内訳、GitHub スタイルのアクティビティヒートマップ、プロジェクト別の帰属表示
• 🖥️ ネイティブデスクトップアプリ — macOS メニューバー（ウィジェット付き）と Windows システムトレイ。それぞれ組み込みサーバーとネイティブ WebView のダッシュボードを備えます
• 🎨 4 種類のデスクトップウィジェット — Pin Usage / Activity Heatmap / Top Models / Usage Limits をデスクトップに固定
• 📈 リアルタイムの利用上限 — Claude / Codex / Cursor / Gemini / Kimi / Kiro / Grok / Copilot / Antigravity / ZCode / OpenCode Go / Qoder / Qoder CN / Command Code / Ark Coding Plan / Ark Agent Plan / Devin / WorkBuddy の上限を表示し、ローカル provider アプリが一時的に終了しても last-good キャッシュを保持
• 🟢 サービス状況ページ — 8 つの公式 provider ステータスページから稼働状況と障害情報を表示
• 💰 コストエンジン — LiteLLM 経由で 2,200+ モデルの価格設定（毎日自動更新）に加え、ニッチなツール（Kiro、Cursor Composer、Kimi、CodeBuddy hy3）向けに厳選された上書き設定。24 時間のディスクキャッシュ + 同梱のオフラインスナップショットにより、ネット接続なしでも正確な USD 表示が可能です。ベンダーが公式価格を公開していないモデル（例: Tencent hy3-preview）はトークン数のみ追跡され、ベンダーが料金を公開するまでコストは $0 と表示されます。
• 🌐 オプションのリーダーボード — 世界中の開発者と比較。ドラッグで列を並び替えて、気になるプロバイダーに絞り込めます（オプトイン制、参加にはサインインが必要）
• 🔄 デバイス横断アカウントビュー — クラウド同期をオンにすると、利用しているすべてのマシン（ノート + デスクトップ + サーバー）の使用量を 1 つのビューに統合 — 合計・トレンド・ヒートマップ・モデル内訳をすべてデバイス横断で集計（オプトイン制、サインインが必要）
• 🧩 オプションの Skills タブ — anthropics/skills、ComposioHQ/awesome-claude-skills、skills.sh、そして自分で追加した任意の GitHub リポジトリから 250+ の公開 Skill をブラウズ。Claude / Codex / AStudio / Gemini / OpenCode / Hermes にターゲット名を付けて同期し、ワンクリックで Undo
• 🔒 プライバシー最優先 — ローカルの使用量メトリクス（トークン数、タイムスタンプ、モデル名）のみを記録。プロンプト、生成テキスト、コードがマシン外に出ることはありません。

🖼️ ショーケース

ダッシュボード — 使用トレンド、モデル別内訳、コスト分析	デスクトップウィジェット — 使用状況をデスクトップに固定
メニューバーアプリ — アニメーション付きの Clawd コンパニオン + ネイティブパネル	グローバルリーダーボード — 世界中の開発者と比較
Skills Manager — GitHub と skills.sh から 250+ の公開 Skill をブラウズし、一度インストールするだけで Claude / Codex / AStudio / Gemini / OpenCode / Hermes に同期。ターゲットごとのトグル、ワンクリック Undo、ファイルの手動コピー不要。
デスクトップペット — デスクトップに浮かぶピクセルコンパニオン。実際のトークン消費に反応し、コーディング中は一緒に作業、連続使用ではお祝い、休憩中は居眠り。codex-pets.net のリンクか .codex-pet.zip でコミュニティペットをインポートでき、V2 ペットはカーソルを 16 方向で追いかけます。macOS / Windows / Web 対応。

🔌 対応 AI ツール

プラグインや hook を手動でインストールする必要はありますか? いいえ。tokentracker（または tokentracker init）が初回実行ですべて処理します:

• Hook ベースのツール (Claude Code、Codex、AStudio、Gemini、Every Code、CodeBuddy、WorkBuddy、Grok Build) — ツール自身の設定に SessionEnd hook または TOML notify エントリーを書き込みます。
• プラグインベースのツール (OpenCode、OpenClaw) — プラグインは npm パッケージ内に同梱されています。OpenClaw のセッションプラグインは ~/.tokentracker/tracker/openclaw-plugin/openclaw-session-sync/ にあり、OpenClaw 自身の CLI でリンクして有効化したうえで、同期を起動するセッション終了イベントを許可するために hooks.allowConversationAccess=true を設定します。ダウンロードもドラッグ＆ドロップも不要です。
• パッシブリーダー (Cursor、Kiro、Hermes、Kimi Code、Copilot、Grok Build、oh-my-pi、pi、Craft Agents、Reasonix、Muse Code、Kilo CLI、Kilo Code、Roo Code、Antigravity、Zed Agent、Goose、Droid、Mimo Code、DuMate、ZCode、LM Studio、Unsloth Studio、OpenSquilla、AnythingLLM Desktop、Devin CLI、MiniMax Code、Claude Science、DeepSeek Harness、Cline) — これらのツールには何もインストールしません。ツールがすでに出力しているファイル (SQLite DB、JSONL、OTEL エクスポート、session logs) を読むだけです。Copilot App / CLI の使用量は ~/.copilot/session-store.db からリクエスト単位で読み取ります。data.db は旧データ移行時のベースラインとして一度だけ使い、store が正規ソースになった後は監視専用です。Chat 拡張と旧 CLI は引き続き OTEL を使用し、重複するリクエストは TokenTracker が一度だけ集計します。移行前の混在 App/CLI 履歴でモデルを安全に分離できない残量は、推測したリクエストモデルではなく github-copilot-legacy の集計値として保持します。
• Grok Build の推定 — 現在のローカルテレメトリは updates.jsonl の累積 totalTokens を公開していますが、安定したプロンプト/出力/キャッシュの内訳はありません。signals.json は contextTokensUsed のスナップショットを使ったフォールバックとして残っています。コールごとの利用詳細が利用可能になるまで、TokenTracker は Grok のコストを推定します。
• Grok の製品別シェア — Grok の制限カードは、共有の週間または月間プールを1本のバーで合計使用量として表示します。カードを展開すると（macOS のメニューバーではカードをクリック）、そのバーが製品ごとのセグメント（Grok Build、チャット、ボイス、Imagine、および請求 API が返すその他の製品）に分かれ、下に各製品の割合を示す凡例が表示されます。セグメントは1つの上限の内訳であり、別々の上限ではないため、このバーは「残り」表示でも常に使用済みの％を表示します。

いつでも tokentracker status を実行すれば、各統合の状態を確認できます。skipped と表示されている場合、detail 列にその理由が示されます（例: ツール CLI が PATH にない、設定が読めない）。

もっと深く知りたい方へ: OpenClaw 統合とトラブルシューティング。

お使いのツールが見当たらない? Issue を立ててください — 新しいプロバイダーの追加は、たいていパーサーファイル 1 つで済みます。

🆚 なぜ TokenTracker?

ウィジェットや視覚的ダッシュボードを備えたデスクトップ体験をお探しですか？ TokenTracker は、多数の AI コーディングツールに対するローカルファースト解析と、ネイティブデスクトップアプリ、デスクトップウィジェット、プロバイダー横断の利用制限監視、任意のクラウド同期を組み合わせています。

🏗️ 仕組み

flowchart LR
    A["AI coding tools<br/>Claude Code · Codex · AStudio · Cursor · Gemini · Kiro<br/>OpenCode · OpenClaw · Every Code · Hermes · Copilot<br/>Kimi · CodeBuddy · WorkBuddy · Grok · Kilo · Roo · Zed · Goose<br/>Antigravity · oh-my-pi · pi · Craft · Droid · Mimo · DuMate · ZCode · Qoder · AnythingLLM · Claude Science · DeepSeek Harness · TRAE · TRAE Work CN · LM Studio · Unsloth Studio · Devin CLI · MiniMax Code · Cline · Command Code"]
    A -->|hooks trigger| B[Token Tracker]
    B -->|parse logs<br/>30-min UTC buckets| C[(Local SQLite)]
    C --> D[Web Dashboard]
    C --> E[Menu Bar App]
    C --> F[Desktop Widgets]
    C -.->|opt-in| G[(Cloud Leaderboard)]

1. AI CLI ツールが通常利用中にログを生成
2. 軽量な hook が変更を検出して同期をトリガー（Cursor は hook ではなく API を使用）
3. トークン数をローカルで解析 — プロンプト、生成テキスト、コードを保存・アップロードすることは一切ありません
4. UTC の 30 分単位バケットに集計
5. ダッシュボード、メニューバーアプリ、ウィジェットはすべて同じローカルスナップショットから読み取る

🛡️ プライバシー

📄 プライバシーポリシー全文（英語）— アプリが行いうるすべてのネットワークリクエスト、その送信内容、そして無効化の方法を網羅しています。

TokenTracker は使用量データをローカルで処理します。プロンプト、コード、モデルの応答を収集またはアップロードすることはありません。

📦 設定

ほとんどのユーザーは触る必要がありません — デフォルトで十分に機能します。高度な設定向け:

🛠️ 開発

git clone https://github.com/xiufengsun/TokenTracker.git
cd TokenTracker
npm install

# ダッシュボードをビルドして CLI を実行
cd dashboard && npm install && npm run build && cd ..
node bin/tracker.js

# テスト
npm test

macOS アプリのビルド

cd TokenTrackerBar
npm run dashboard:build              # ダッシュボードバンドルをビルド
./scripts/bundle-node.sh             # Node.js + tokentracker ソースをバンドル
xcodegen generate                    # Xcode プロジェクトを生成
ruby scripts/patch-pbxproj-icon.rb   # Icon Composer アセットをパッチ適用
xcodebuild -scheme TokenTrackerBar -configuration Release clean build
./scripts/create-dmg.sh              # .app を DMG にパッケージ化

Xcode 16+ と XcodeGen が必要です。

🔧 トラブルシューティング

CLI

node --version

PORT=7700 tokentracker serve

lsof -i :7680

tokentracker status

tokentracker doctor

tokentracker uninstall

macOS アプリ

xattr -cr /Applications/TokenTracker.app

🪪 README バッジ

GitHub プロフィールやプロジェクトの README で自分のトークン使用量をアピールしましょう。

YOUR_USER_ID の取得方法:

1. tokentracker を実行してダッシュボードを開き、リーダーボードにサインインします。
2. Settings → Account に移動します。
3. そこに表示される User ID を使います。headless / SSH 環境では、tokentracker device-login も同じ user_id を ~/.tokentracker/tracker/config.json に書き込みます。

以下のどれかを貼り付けてください:

[![tokens](https://srctyff5.us-east.insforge.app/functions/tokentracker-badge-svg?user_id=YOUR_USER_ID&metric=tokens)](https://github.com/xiufengsun/TokenTracker)
[![cost](https://srctyff5.us-east.insforge.app/functions/tokentracker-badge-svg?user_id=YOUR_USER_ID&metric=cost)](https://github.com/xiufengsun/TokenTracker)
[![rank](https://srctyff5.us-east.insforge.app/functions/tokentracker-badge-svg?user_id=YOUR_USER_ID&metric=rank)](https://github.com/xiufengsun/TokenTracker)

リンク先はデフォルトで TokenTracker リポジトリに設定してあり、クリックがそのまま他の開発者の発見につながります。あなた自身の leaderboard プロフィール、個人サイト、または https://www.tokentracker.cc に飛ばしたい場合は URL を差し替えてください。

現在の合計を反映した shields.io 互換バッジが描画されます（60 秒キャッシュ）:

プライバシー: バッジはリーダーボード共有が オン (Settings → Account → Public profile) のプロフィールに対してのみ解決されます。非公開プロフィールには「private」プレースホルダーが返ります。

⭐ Star History

🤝 コントリビューション & サポート

• バグ / 機能リクエスト: Issue を立てる
• セキュリティ: SECURITY.md を参照 — セキュリティ報告は公開 Issue として立てないでください
• プルリクエスト: セットアップ、テスト、新しい AI ツール統合の追加方法は CONTRIBUTING.md を参照
• 質問 / ショーケース: GitHub Discussions

🙏 クレジット

bot コンパニオンのモーフィングエンジンは Jérémy Perret 氏の bloub（MIT）です。

Clawd キャラクターのデザインは Anthropic に帰属します。本プロジェクトはコミュニティ主導のものであり、Anthropic との公式な提携関係はありません。

🔗 リンク

• LINUX DO — 開発者コミュニティ

ライセンス

MIT