{"id":48941985,"url":"https://github.com/jeongwookie/WhereMyTokens","last_synced_at":"2026-04-20T01:00:54.254Z","repository":{"id":351245611,"uuid":"1201849259","full_name":"jeongwookie/WhereMyTokens","owner":"jeongwookie","description":"Windows system tray app for monitoring Claude Code token usage in real time","archived":false,"fork":false,"pushed_at":"2026-04-16T06:50:31.000Z","size":3518,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-16T08:40:01.234Z","etag":null,"topics":["anthropic","anthropic-claude","claude-ai","claude-code","developer-tools","electron","system-tray","token-usage","windows"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeongwookie.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-05T08:49:30.000Z","updated_at":"2026-04-16T06:50:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jeongwookie/WhereMyTokens","commit_stats":null,"previous_names":["jeongwookie/wheremytokens"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/jeongwookie/WhereMyTokens","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongwookie%2FWhereMyTokens","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongwookie%2FWhereMyTokens/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongwookie%2FWhereMyTokens/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongwookie%2FWhereMyTokens/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeongwookie","download_url":"https://codeload.github.com/jeongwookie/WhereMyTokens/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongwookie%2FWhereMyTokens/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32028547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"ssl_error","status_checked_at":"2026-04-20T00:17:31.068Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic","anthropic-claude","claude-ai","claude-code","developer-tools","electron","system-tray","token-usage","windows"],"created_at":"2026-04-17T14:00:47.655Z","updated_at":"2026-04-20T01:00:54.245Z","avatar_url":"https://github.com/jeongwookie.png","language":"TypeScript","funding_links":[],"categories":["Developer Tools","Tools","LLM Ops","3. \u003ca name='Dev'\u003e\u003c/a\u003e💻 Dev","Companion Apps \u0026 GUIs","Agent Infrastructure"],"sub_categories":["Sync and Clone","Stat","Multi-Agent / Orchestration Frameworks","GateGuard — Fact-Forcing PreToolUse Gate","Usage Analytics \u0026 Cost Tracking"],"readme":"\u003cimg src=\"assets/source-icon.png\" width=\"80\" align=\"right\" /\u003e\n\n# WhereMyTokens\n\n**Claude Code のトークン使用量をリアルタイムで監視する Windows システムトレイアプリ。**\n\nClaude Code を毎日使う韓国人開発者が、自分のために作って使い続けているアプリです。\n\nタスクバーに常駐し、Claude Code の使用状況 — トークン数、コスト、セッション活動、レート制限 — を一目で確認できます。\n\n![Platform](https://img.shields.io/badge/platform-Windows_10%2F11-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n![Release](https://img.shields.io/github/v/release/jeongwookie/WhereMyTokens)\n\n\u003e [English](README.md) | [한국어](README.ko.md) | [中文](README.zh-CN.md) | [Español](README.es.md)\n\n\u003e 💾 **クラウド同期なし** — ローカルの Claude ファイルのみを読み取ります。データは外部に送信されません。\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth width=\"50%\"\u003eライトモード\u003c/th\u003e\n    \u003cth width=\"50%\"\u003eダークモード\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/screenshot-light.png\" alt=\"Light mode\" /\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/screenshot-dark.png\" alt=\"Dark mode\" /\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth width=\"33%\"\u003eRhythm \u0026 ピーク統計\u003c/th\u003e\n    \u003cth width=\"33%\"\u003e7 日間ヒートマップ\u003c/th\u003e\n    \u003cth width=\"33%\"\u003e設定\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/screenshot-rhythm.png\" alt=\"Rhythm tab\" /\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/screenshot-heatmap.png\" alt=\"7-day heatmap\" /\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/screenshot-settings.png\" alt=\"Settings\" /\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## ダウンロード\n\n**[⬇ 最新リリースをダウンロード](https://github.com/jeongwookie/WhereMyTokens/releases/latest)**\n\n1. `WhereMyTokens-v1.9.1-win-x64.zip` をダウンロード\n2. 任意の場所に展開\n3. `WhereMyTokens.exe` を実行\n\nインストール不要 — アプリが自動で開き、システムトレイに常駐します。\n\n---\n\n## 主な機能\n\n### セッション追跡\n- **リアルタイムセッション検出** — ターミナル、VS Code、Cursor、Windsurf など、リアルタイム状態：`active` / `waiting` / `idle` / `compacting`\n- **2 段階グループ化** — git プロジェクト → ブランチ別、プロジェクトごとのコミット・行数統計\n- **Idle 自動非表示** — idle セッションは段階的に折りたたみ；6 時間以上は自動非表示（展開可能）\n- **コンテキストウィンドウ警告** — セッションごとのバー；50% で琥珀色、80% でオレンジ、95%+ で赤\n- **ツール使用バー** — 比例色分けバー + ツールチップ（Bash、Edit、Read など）\n\n### レート制限 \u0026 アラート\n- **レート制限バー** — Anthropic API 5 時間・週間使用量、プログレスバー、リセットカウンター、キャッシュ効率グレード\n- **Claude Code ブリッジ** — `statusLine` プラグインで API ポーリングなしのリアルタイムデータ受信\n- **Windows トースト通知** — 使用量しきい値（50% / 80% / 90%）でアラート\n- **Extra Usage 予算** — 月間クレジット使用量 / 上限 / 利用率\n\n### 分析 \u0026 アクティビティ\n- **ヘッダー統計** — today/all-time トグル：コスト、API 呼び出し、セッション、キャッシュ効率、節約額、トークン内訳（In/Out/Cache）\n- **アクティビティタブ** — 7 日間ヒートマップ、5 ヶ月カレンダー（GitHub スタイル）、時間帯別分布、4 週間比較\n- **Rhythm タブ** — 時間帯別コスト分布（Morning/Afternoon/Evening/Night）、グラデーションバー、ピーク詳細統計、ローカルタイムゾーン\n- **モデル別分析** — モデルごとのトークン・コスト合計、グラデーションバー\n- **Activity Breakdown** — セッション別 output トークン 10 カテゴリ分析（Thinking、Edit/Write、Read、Search、Git など）\n\n### Code Output \u0026 生産性\n- **Git ベース指標** — コミット数、純変更行数、**$/100 Lines**（100 行追加あたりのコスト）\n- **Today vs All-time** — 今日の実際のコストと全期間平均を比較\n- **自動検出** — `~/.claude/projects/` の履歴から Claude 使用全プロジェクトを含む\n- **自分のコミットのみ** — `git config user.email` でフィルタリング\n\n### カスタマイズ\n- **Auto/Light/Dark テーマ** — デフォルトはシステム設定に従う\n- **コスト表示** — USD または KRW、為替レート設定可能\n- **常に最前面ウィジェット** — 他のウィンドウの上に固定；ヘッダーボタン、トレイアイコン、グローバルホットキーで最小化\n- **トレイラベル** — 使用量 %、トークン数、コストを直接表示\n- **プロジェクト管理** — 非表示または追跡から完全除外\n- **Windows 起動時に自動起動** — オプション\n\n---\n\n## クイックスタート\n\n### 1. ダッシュボードを開く\nトレイアイコンをクリック（またはグローバルショートカット `Ctrl+Shift+D`）。\n\n### 2. Claude Code ブリッジを接続（オプション）\n**Settings → Claude Code Integration → Setup** — API ポーリングなしでリアルタイムデータ受信。\n\n### 3. 設定\n- **通貨** — USD または KRW\n- **アラート** — 使用量しきい値の設定（50% / 80% / 90%）\n- **テーマ** — Auto（システム設定に従う）/ Light / Dark\n- **トレイラベル** — タスクバーに表示する情報を選択\n\n---\n\n## Claude Code 連携（ブリッジ）\n\nWhereMyTokens は公式の `statusLine` プラグインメカニズムを通じて、Claude Code からリアルタイムのレート制限データを受信できます — API ポーリング不要。\n\n**仕組み：**\n1. **Settings → Claude Code Integration → Setup** を実行\n2. `~/.claude/settings.json` に WhereMyTokens を `statusLine` コマンドとして登録\n3. Claude Code が実行されるたびに、セッションデータ（レート制限、コンテキスト %、モデル、コスト）を stdin 経由で送信\n4. アプリが即座に更新 — ポーリングの遅延なし\n\nブリッジはコンテキストウィンドウ %、モデル、コストなどの補助データを提供します。レート制限のパーセンテージは常に Anthropic API を権威あるソースとして使用し、API が利用できない場合のみブリッジ値にフォールバックします。\n\n---\n\n## レート制限の仕組み\n\n優先順位順に 2 つのデータソースを使用：\n\n| 優先度 | ソース | 説明 |\n|--------|--------|------|\n| 第 1 | **Anthropic API** | `/api/oauth/usage` — ウェブダッシュボードと同じ権威あるデータ。3 分ごとに取得、429 時は指数バックオフ。 |\n| 第 2 | **ブリッジ（stdin）** | `statusLine` 経由で Claude Code からのリアルタイムデータ。API 不可時のフォールバック。 |\n| フォールバック | **最後の既知の値** | API 失敗時は最後の成功値を保持。リセット済みの古いデータは自動クリア。 |\n\nヘッダーのドットは API 接続状態を示します（緑 = 接続中、赤 = 到達不可）。ドットにマウスを合わせるとエラーメッセージを確認できます。\n\n---\n\n## 数値の計算基準\n\nすべてのトークン数は **input + output + キャッシュ生成 + キャッシュ読み取り** を含みます。コストは常に API 換算推定値。\n\n| 表示場所 | 範囲 | 含まれる内容 |\n|---------|------|------------|\n| ヘッダー (today) | 今日の深夜以降 | In/Out/Cache + 呼び出し数、セッション数、キャッシュ節約 |\n| ヘッダー (all) | 全期間 | In/Out/Cache + 呼び出し数、セッション数、キャッシュ節約 |\n| Plan Usage (5h / 1w) | 現在の請求ウィンドウ | すべてのトークン種別 |\n| Model Usage | 全期間、モデル別 | すべてのトークン種別 |\n\n\u003e **注意：** `$` 値は推定値であり、実際の請求額ではありません。Claude Max/Pro サブスクリプションは月額固定料金であり、コスト表示はサブスクリプションから得られる使用価値を示します。\n\n---\n\n## アクティビティタブ\n\n| タブ | 説明 |\n|------|------|\n| 7d | 7 日間ヒートマップ（曜日 × 時間グリッド）、時間軸 + 色凡例 |\n| 5mo | 5 ヶ月カレンダーグリッド（GitHub スタイル、日付+トークンをホバー表示） |\n| Hourly | 直近 30 日間の時間帯別トークン分布 |\n| Weekly | 直近 4 週間の横棒グラフ |\n| Rhythm | 時間帯別コスト分布 — Morning ☀️ / Afternoon 🔥 / Evening 🌆 / Night 🌙、グラデーションバー、ピーク詳細統計、ローカルタイムゾーン（30 日間） |\n\n---\n\n## Activity Breakdown\n\nセッション行の **Breakdown** ボタンをクリックすると、カテゴリ別 output トークン内訳が展開されます。同時に開けるのは 1 つのみ。\n\n| カテゴリ | 色 | ソース |\n|---------|-----|--------|\n| 💭 Thinking | ティール | 拡張思考ブロック |\n| 💬 Response | スレート | テキストブロック — 最終回答 |\n| 📄 Read | ブルー | `Read` ツール |\n| ✏️ Edit / Write | バイオレット | `Edit`, `Write`, `MultiEdit`, `NotebookEdit` |\n| 🔍 Search | スカイ | `Grep`, `Glob`, `LS`, `TodoRead`, `TodoWrite` |\n| 🌿 Git | グリーン | `Bash` — `git` コマンド |\n| ⚙️ Build / Test | オレンジ | `Bash` — `npm`, `tsc`, `jest`, `cargo`, `python` など |\n| 💻 Terminal | アンバー | その他の `Bash` コマンド; `mcp__*` ツール |\n| 🤖 Subagents | ピンク | `Agent` ツール |\n| 🌐 Web | パープル | `WebFetch`, `WebSearch` |\n\n\u003e **トークン配分：** 各ターンの output トークンをコンテンツブロック文字数比率で分配（`ブロック文字数 ÷ 総文字数 × output トークン数`）。値が 0 のカテゴリは非表示。\n\n---\n\n## データ \u0026 プライバシー\n\nWhereMyTokens はローカルファイルのみを読み取ります — クラウド同期なし、テレメトリなし。\n\n| ファイル | 用途 |\n|----------|------|\n| `~/.claude/sessions/*.json` | セッションメタデータ（pid、cwd、モデル） |\n| `~/.claude/projects/**/*.jsonl` | 会話ログ（トークン数、コスト） |\n| `~/.claude/.credentials.json` | OAuth トークン — Anthropic から自分の使用量を取得するためのみ使用 |\n| `%APPDATA%\\WhereMyTokens\\live-session.json` | `statusLine` プラグインのブリッジデータ |\n\n---\n\n## ソースからインストール\n\n### 動作要件\n\n- Windows 10 / 11\n- [Node.js](https://nodejs.org) 18+\n- [Claude Code](https://claude.ai/code) インストール済みでログイン状態\n\n### ビルド \u0026 実行\n\n```bash\ngit clone https://github.com/jeongwookie/WhereMyTokens.git\ncd WhereMyTokens\nnpm install\nnpm run build\nnpm start\n```\n\n### インストーラーのビルド\n\n```bash\nnpm run dist\n# -\u003e release/WhereMyTokens Setup x.x.x.exe  (NSIS インストーラー)\n# -\u003e release/WhereMyTokens x.x.x.exe         (ポータブル)\n```\n\n\u003e **注意：** Windows で NSIS インストーラーをビルドするには開発者モードの有効化が必要です（設定 → 開発者向け → 開発者モード）。`release/win-unpacked/` のポータブル `.exe` は開発者モードなしでも動作します。\n\n---\n\n## デモ\n\n\u003cdiv align=\"center\"\u003e\n\nhttps://github.com/user-attachments/assets/98b6f8d7-6fc6-4c12-aef1-af6300db0728\n\n\u003c/div\u003e\n\n---\n\n## 免責事項\n\n表示されるコストは **API 換算の推定値**であり、実際の請求額ではありません。Claude Max/Pro サブスクリプションは月額固定料金であり、コスト表示はサブスクリプションから得られる使用価値を示します。\n\n---\n\n## コントリビュート\n\nIssue や Pull Request を歓迎します。変更したい内容がある場合は、まず Issue を開いてください。\n\n---\n\n## 謝辞\n\nmacOS 版である [duckbar](https://github.com/rofeels/duckbar) にインスパイアされました。\n\n---\n\n## ライセンス\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeongwookie%2FWhereMyTokens","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeongwookie%2FWhereMyTokens","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeongwookie%2FWhereMyTokens/lists"}