hub / github.com/Javis603/token-monitor

github.com/Javis603/token-monitor

repository ↗ · DeepWiki ↗ · release v0.49.0 ↗ · + Follow · compare 5 versions

5,925 symbols 18,592 edges 524 files ⚖ MIT 8 documented · 0% ● updated 5d agov0.49.0 · 2026-08-28★ 1,77647 open issues

Browse by type

⨍ Functions 5,809◇ Types & classes 116

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

EN | 简 | 繁 | KO | JA

<img src="https://github.com/Javis603/token-monitor/raw/v0.49.0/github/assets/app.png" alt="Token Monitor logo" width="120">
<h1>Token Monitor</h1>







<em>すべての AI コーディングツールのリアルタイム使用量を一画面で、複数デバイス間で同期。</em>







<a href="https://github.com/Javis603/token-monitor/releases"><img src="https://img.shields.io/github/v/release/Javis603/token-monitor?include_prereleases&style=flat-square&label=release&color=22c55e" alt="最新リリース" /></a>
<a href="https://github.com/Javis603/token-monitor/releases"><img src="https://img.shields.io/github/downloads/Javis603/token-monitor/total?style=flat-square&color=22c55e" alt="総ダウンロード数" /></a>
<img src="https://img.shields.io/badge/Windows-10%2B-0078D4?style=flat-square" alt="Windows 10 以降" />
<img src="https://img.shields.io/badge/macOS-12%2B-0A84FF?style=flat-square&logo=apple&logoColor=white" alt="macOS 12 以降" />
<img src="https://img.shields.io/badge/Linux-x64-64748b?style=flat-square&logo=linux&logoColor=white" alt="Linux x64" />
<a href="https://discord.gg/HmdNVVvw5P"><img src="https://img.shields.io/discord/1344259784219689031?color=5865F2&label=Discord&logo=discord&logoColor=white&style=flat-square" alt="Discord"></a>
<a href="https://github.com/Javis603/token-monitor/raw/v0.49.0/LICENSE"><img src="https://img.shields.io/badge/license-MIT-A855F7?style=flat-square" alt="ライセンス: MIT" /></a>







<img src="https://github.com/Javis603/token-monitor/raw/v0.49.0/github/assets/demo.gif">

Token Monitor とは

Claude Code、Codex、Cursor、GitHub Copilot、Cherry Studio など 32+ 種類の AI コーディングツールのリアルタイムトークン使用量と AI ツール制限を表示するデスクトップウィジェットです。複数デバイス間のリアルタイム同期、使用履歴トレンド、ツール・デバイス・モデル・セッション・プロジェクト別の内訳表示に対応しています。

対応ツール

Token Monitor は トークン使用量、アカウント制限、セッション詳細 を個別にサポートします。

ツール	データパス	トークン使用量	AI ツール制限	セッション詳細
Claude Code	`~/.claude/projects/`, `~/.claude/transcripts/`	✅	✅	✅
Codex	`~/.codex/`（`sessions/`、`archived_sessions/`）	✅	✅	✅
OpenCode	`~/.local/share/opencode/`（`opencode*.db`、`storage/message/`）	✅	✅	✅
Hermes Agent	`~/.hermes/state.db`	✅	—	—
OpenClaw	`~/.openclaw/agents/`	✅	—	—
Cursor IDE / Cursor CLI	`~/.config/tokscale/cursor-cache/`（アカウント単位の使用量エクスポート）	✅	✅	—
Antigravity	`~/.gemini/`（`antigravity/`、`antigravity-ide/`、`antigravity-backup/`、`antigravity-cli/conversations/`）	✅	✅	—
Cline	VS Code globalStorage tasks (`.../saoudrizwan.claude-dev/tasks/`)、`~/.cline/data/sessions/`	✅	—	—
Kimi CLI / Kimi Code / Kimi Work	`~/.kimi/sessions/`, `~/.kimi-code/sessions/`, `<platform-app-data>/kimi-desktop/`	✅	✅	—
Qwen CLI	`~/.qwen/projects/`	✅	—	—
Grok Build	`~/.grok/`（`sessions/`、`logs/unified.jsonl`）	✅	✅	—
GitHub Copilot	VS Code `workspaceStorage/*/chatSessions/`、`~/.copilot/`（`otel/`、`data.db`）	✅	✅	—
Pi / Oh My Pi	`~/.pi/agent/sessions/`, `~/.omp/agent/sessions/`	✅	—	—
Zed	`~/.local/share/zed/threads/threads.db`	✅	—	—
Kilo Code	VS Code globalStorage tasks (`.../kilocode.kilo-code/tasks/`) — Linux およびリモート/WSL のみ	✅	—	—
Command Code	`~/.commandcode/projects/*/.jsonl`	✅	✅	—
MiMo Code	`~/.local/share/mimocode/mimocode.db`	✅	✅	—
ZCode / GLM	`~/.zcode/`（`projects/`、`cli/db/db.sqlite`）	✅	✅	—
Kiro	`~/.kiro/sessions/cli/`, Kiro IDE globalStorage および `kiro-cli` DB	✅	✅	—
CodeBuddy	`~/.codebuddy/projects/` + IDE / VS Code 拡張ログ	✅	—	—
WorkBuddy	`~/.workbuddy/projects/`, `~/.workbuddy/workbuddy.db`	✅	✅	—
Proma	`~/.proma/agent-sessions/*.jsonl`	✅	—	—
Qoder	`<platform-app-data>/QoderCN/SharedClientCache/cache/db/local.db`（中国版のみ）	✅	✅	—
Reasonix	`~/.reasonix/`（`stats/`、`sessions/`、`projects/*/sessions/`）	✅	—	—
DeepSeek / DeepSeek Harness	`~/.dsh/sessions/`（`session.jsonl`、`session.jsonl.zstd`）	✅	✅	✅
Cherry Studio	`<platform-app-data>/CherryStudio/`（`Data/Agents/.claude/projects/` V2、`.claude/projects/` legacy）	✅	—	—
OpenRouter	OpenRouter API キー（使用量／キー上限。creditsアクセス許可時は残高も表示。公式文書ではManagementキーを指定）	—	✅	—
Minimax	Minimax API キー（Minimax API で Token Plan クォータ取得）	—	✅	—
Volcengine	Ark API key または Volcengine AK/SK（Volcengine API で Ark Coding Plan / Agent Plan クォータ取得）	—	✅	—
Ollama	Ollama Cloud cookie（ollama.com/settings で session/weekly 使用量を取得）	—	✅	—
Trae CN	Trae CN access token（trae.cn で Trae CN／SOLO credits を取得）	—	✅	—
サードパーティAPI	New API / Sub2API互換アカウントプリセット（互換性のあるOne APIフォークを含む）、New APIキープリセット、カスタム残高エンドポイント	—	✅	—

注意事項、Custom 残高エンドポイント、環境変数で変更したデータパス

上記はデフォルトのパスです。Token Monitor は Tokscale と同じ環境変数の上書きに従います。~/.local/share/ 配下は $XDG_DATA_HOME、ツール個別では $CODEX_HOME、$GROK_HOME、$HERMES_HOME、$KIMI_CODE_HOME、$DSH_HOME、$REASONIX_STATE_HOME、$REASONIX_HOME、$CLINE_* などです。
Command Code の transcript には実際のトークン数やメッセージごとのモデル情報が含まれません。トークン使用量は transcript テキストから推定され、モデルの帰属と推定コストには各リクエストで過去に使用したモデルではなく、現在設定されているモデルが反映される場合があります。
Cursor キャッシュは Cursor のアカウント単位の使用量エクスポートから取得されるため、Cursor IDE と Cursor CLI の両方が対象です。Token Monitor は Cursor デスクトップアプリでログイン済みのアカウントを自動検出し、設定から手動でアカウントを追加することもできます。古いキャッシュは自動的に再同期されますが、終了直後のセッションが Cursor ダッシュボードに届くまで数分かかる場合があるため、使用量は即時ではなく同期後に更新されます。
Custom は1つの GET 残高エンドポイントから数値 JSON フィールドをマッピングします。OpenAI または Anthropic API 互換だけでは不十分です。

Qoder CN（ローカルアダプター）

Qoder CN のトークン使用量は API ではなくアプリのローカル SQLite データベースから読み取ります。Settings → tools で有効化します（オプトイン、デフォルト無効）。データベースはプラットフォームごとに自動検出されます：macOS ~/Library/Application Support/QoderCN/SharedClientCache/cache/db/local.db、Windows %APPDATA%\QoderCN\SharedClientCache\cache\db\local.db、Linux ~/.config/QoderCN/SharedClientCache/cache/db/local.db — TOKEN_MONITOR_QODER_CN_DB_PATH で上書き可能です。

これは高度なローカル統合です：読み取りには PATH 上の sqlite3 CLI、またはフラグ不要の node:sqlite を備えた Node ランタイム（Node ≥ 23.4、Electron では CLI が必要な場合あり）が必要です。読み取りエラーはログに記録され、完全な既存スナップショットがあればゼロ使用量で上書きせず保持します。コストはマッピングされた各モデルの models.dev カタログ料金から推定されます。Qoder がデータベーススキーマを変更すると動作しなくなる可能性があります。

ショーケース

_{カスタマイズ可能なダッシュボード — 表示するモジュールと順序を選択}	_{複数アカウントを並べて表示、Codex はローカルアカウントをワンクリック切り替え}	_{任意のツールをクリックして入力／出力とキャッシュヒットの内訳を展開}
_{単一セッションを開いて、プロンプトごとにトークンと使用ツールを分解}	_{ツール横断で各モデルの使用量とコストを集計}	_{各デバイスの使用量・コスト・同期状態、展開でマシン別詳細}

_{全デバイス横断の 1 年分アクティビティヒートマップと連続日数}

_{1 年分の日次トレンド、ツール／モデル別に積み上げ、K 線対応}

Token Monitor を使う理由

多くの使用量モニターは、実行しているマシン上でのみ役立ちます。Token Monitor はマルチデバイス作業のために設計されています。各デバイスがローカルログを監視し、hub にサマリーを送信すると、接続されたすべてのウィジェットがトークンの変化をほぼリアルタイムで確認できます。

機能

使用量の追跡

リアルタイムトークン追跡 — Claude Code、Codex、Cursor、GitHub Copilot、Antigravity、OpenCode など 26+ 種類の AI ツール、各ターンから数秒以内に UI 更新（全リストは上の表を参照）
セッション別詳細 — Claude Code、Codex、OpenCode セッションでプロンプトごとのトークン、各応答のトークン分割・使用ツールまで展開（ローカル transcript/DB を必要時のみ読み込み、同期しない）
キャッシュヒット統計 — ツール・モデルをクリックすると入力トークン（キャッシュ hit/miss）、出力トークン、ヒット率の詳細
コストと通貨 — トークン数とともにコストを表示。USD、TWD、HKD、CNY に対応し、為替レートは毎日自動更新、設定で手動上書き可能
WSL 使用量 (Windows) — 実行中の WSL ディストリビューションにあるファイルベースの使用量を約 5 分ごとに自動検出して合算。OpenCode や Hermes など SQLite ベースのツールでは、WSL 内のヘッドレスエージェントが必要になる場合があります

制限・トレンド・エクスポート

AI ツール制限検出 — Claude Code、Codex、Cursor、OpenRouter、サードパーティAPI、GLM、Kimi など 21+ プロバイダーの session/daily/weekly/billing/credits、複数の OpenRouter／サードパーティプロファイル、DeepSeek プリペイド残高と使用額
複数アカウントと Codex 切り替え — 1 つのプロバイダーで複数アカウントを追跡し、それぞれの制限を表示。追跡済みの Codex アカウントは、再認証なしでローカルアカウントとしてワンクリック切り替え可能
削除されたセッション使用量を保持 — 多くのツールは古いセッションを削除します（Claude Code はデフォルトで 30 日後にトランスクリプトを削除）。有効にすると、Token Monitor は観測済みの日別ツール/モデル使用量をローカルにアーカイブし、元ファイルが消えてもヒートマップとトレンドを維持します（下記セッションデータの保持期間を参照）
使用トレンド & ダッシュボード — ホーム画面のアクティビティヒートマップ・トレンドチャート、連続日数・全デバイス横断のツール/モデル別累積使用（棒・K 線）専用ダッシュボードウィンドウ
ステータスビュー（任意） — Claude、OpenAI、Cursor、DeepSeek のステータスページを手動/定期確認
データエクスポート — ツール非依存の CSV + JSON で手動エクスポートまたはフォルダへの自動書き込み（スプレッドシート、Obsidian、Grafana、スクリプト用）；docs/export.md を参照
サブスクリプション記録 — 各 AI アカウントの実際の費用を手動で記録します。プランラベルのツールチップに料金、次回更新日または終了日、利用期間、当月の使用量コストが支払額の何倍かが表示され、定期プランとチャージ履歴のどちらにも対応

マルチデバイスとデプロイ

マルチデバイスリアルタイム同期 — Server-Sent Events。1 台の変更が数秒以内に他のデバイスに反映
ローカルファースト — 単一デバイスではサーバー不要
セルフホスト同期 — ウィジェット内 hub、Node CLI hub、Cloudflare Worker
iOS ウィジェット — Worker hub + Widgy、Scriptable
プライバシー優先 — プロンプト、応答、ソースコード、ファイル内容はすべてデバイス内に保持

インターフェースと表示

内訳ビュー — ツール、デバイス、モデル、セッション、プロジェクト、アカウント制限別
メニューバー (macOS) / システムトレイ (Windows) — コスト、トークン、または残量が最も少ないプロバイダー制限 % をアイコン横に表示
フローティングバブル — ドラッグ可能なミニウィンドウ、クリック/ホバープレビュー
メニューバーのレイアウト編集 — メニューバーとフローティングバブルは内蔵プリセットのほか、「カスタム…」で自分で組み立て可能。AIツールアイコン、制限バー、パーセント、リセット時間、コスト、カスタムテキストを追加し、ライブプレビューを見ながらドラッグで並べ替え、項目ごとに AIツール・アカウント・制限期間・フォントを指定
外観 — テーマ（ライトモード含む）、ツール別カラー、ガラス透明度・ぼかし、透明ウィンドウ
実験的なネイティブ macOS ウィジェット — macOS 14 以降のみ対応し、小・中・大の各サイズと、概要・クォータ・モデル・アクティビティ・トレンドの各ページを提供します。現時点ではソースコード上のプレビューであり、正式 Release への同梱を示すものではありません
ツールリストのカスタマイズ — 追跡は維持したまま非表示、ピン留め、順序変更
グローバルショートカット — どこからでもウィンドウの表示/非表示
Discord Rich Presence — 本日のトークン・コスト・主要クライアント（オプトイン）

インストール

GitHub Releases からダウンロードできます。

macOS (Apple Silicon) — .dmg、署名および notarize 済み
macOS (Intel) — x64 .dmg、署名および notarize 済み
Windows 10/11 — インストーラー版とポータブル版の .exe、署名済み
Linux x64 — .AppImage

パッケージ版は GitHub Releases を自動確認します。新しいバージョンがある場合は画面に更新インジケーターが表示され、対応プラットフォームでは設定 → 一般からもインストールできます。

初回起動

ローカルモードがデフォルトです。アプリを起動すると、このデバイスの追跡を開始します。hub、agent、設定は不要です。

マルチデバイス同期

すべてのデバイス（および headless agent）が接続する hub を 1 つ 選びます。各デバイスでウィジェットを開き、設定 → マルチデバイス同期 でモードを選択します。ウィジェットがこのデバイスの使用量を自動的にアップロードします。ウィジェットがないマシンでのみ npm run agent を実行してください。

オプション A — ウィジェットから hub をホスト（最も簡単、CLI 不要）

常時起動のマシンで 設定 → マルチデバイス同期 → このデバイスでHubをホスト を選択します。ウィジェットが secret を生成し、LAN URL（Tailscale/ZeroTier 含む）を表示します。他のデバイスでは Hubに接続 に URL と secret を貼り付けます。

Token Monitor が実行中の間のみ hub が動作します。アプリを終了すると（ウィンドウを閉じるだけではなく）hub が停止し、接続されたデバイスが切断されます。

オプション B — Node hub をセルフホスト（常時 headless マシン）

# 常時起動のマシンで
cp .env.example .env
# TOKEN_MONITOR_SECRET を非公開の値に設定してから:
npm run hub

オプション C — Cloudflare Worker hub（ネットワーク間、iPhone 含む

Extension points exported contracts — how you extend this code

—

browse all types & interfaces →

Core symbols most depended-on inside this repo

↓ 146 filesWidgetHeatmapLayoutCalculator

native/macos/TokenMonitorWidget/WidgetViewModel.swift

↓ 38 filesWidgetLayoutRegionPreferenceKey

native/macos/TokenMonitorWidget/TokenMonitorWidget.swift

↓ 23 fileshashKey

src/shared/hashKey.js

↓ 20 filesnormalizeLimitProvider

src/shared/limits.js

↓ 18 filescallback

src/electron/tray.js

↓ 13 filesaggregateDevices

src/shared/usage.js

browse all functions →

Shape

Function 5,488

Method 321

Struct 47

Class 34

Enum 34

Interface 1

Languages

TypeScript94%

Swift6%

Modules by API surface

src/electron/renderer/app.js775 symbols

src/electron/main.js346 symbols

src/shared/limitCollector.js237 symbols

src/shared/collector.js159 symbols

native/macos/TokenMonitorWidgetTests/WidgetSnapshotDecodingTests.swift92 symbols

native/macos/TokenMonitorWidget/TokenMonitorWidget.swift76 symbols

native/macos/TokenMonitorWidget/WidgetConfigurationIntent.swift74 symbols

worker/src/shared/usage.js71 symbols

src/shared/usage.js71 symbols

site/scripts/main.js70 symbols

src/electron/renderer/trayComposer.js63 symbols

tests/electron/limitProviderPresentation.test.js62 symbols

Dependencies from manifests, versioned

@electron/osx-sign1.3.3 · 1×

@eslint/compat2.1.0 · 1×

@eslint/js10.0.1 · 1×

@xhayper/discord-rpc1.3.4 · 1×

chokidar4.0.3 · 1×

dotenv17.4.2 · 1×

electron43.4.0 · 1×

electron-builder26.15.3 · 1×

electron-updater6.8.9 · 1×

esbuild0.28.1 · 1×

eslint10.8.0 · 1×

globals17.9.0 · 1×

For agents

$ claude mcp add token-monitor \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

github.com/Javis603/token-monitor @v0.52.0@v0.51.0@v0.50.0@v0.49.0@v0.21.0

Token Monitor とは

対応ツール

Qoder CN（ローカルアダプター）

ショーケース

Token Monitor を使う理由

機能

使用量の追跡

制限・トレンド・エクスポート

マルチデバイスとデプロイ

インターフェースと表示

インストール

初回起動

マルチデバイス同期

オプション A — ウィジェットから hub をホスト（最も簡単、CLI 不要）

オプション B — Node hub をセルフホスト（常時 headless マシン）

オプション C — Cloudflare Worker hub（ネットワーク間、iPhone 含む

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Languages

Modules by API surface

Dependencies from manifests, versioned

For agents

Ask about this repo answers extend the page

github.com/Javis603/token-monitor