{"id":51012523,"url":"https://github.com/long-910/tmux-claude-status","last_synced_at":"2026-06-21T05:01:58.429Z","repository":{"id":340061332,"uuid":"1164363900","full_name":"long-910/tmux-claude-status","owner":"long-910","description":"Claude Code token usage display for tmux status bar","archived":false,"fork":false,"pushed_at":"2026-05-16T13:20:19.000Z","size":99,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-25T21:38:39.804Z","etag":null,"topics":["claude","claude-code","status","tmux","usage","visualization"],"latest_commit_sha":null,"homepage":"","language":"Python","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/long-910.png","metadata":{"files":{"readme":"README.ja.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"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-02-23T01:52:23.000Z","updated_at":"2026-05-16T13:18:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"7a23153e-bc5c-4d2e-8d15-4dd56177391e","html_url":"https://github.com/long-910/tmux-claude-status","commit_stats":null,"previous_names":["long-910/claude-tmux-status","long-910/tmux-claude-status"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/long-910/tmux-claude-status","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/long-910%2Ftmux-claude-status","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/long-910%2Ftmux-claude-status/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/long-910%2Ftmux-claude-status/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/long-910%2Ftmux-claude-status/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/long-910","download_url":"https://codeload.github.com/long-910/tmux-claude-status/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/long-910%2Ftmux-claude-status/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34594326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["claude","claude-code","status","tmux","usage","visualization"],"created_at":"2026-06-21T05:01:54.772Z","updated_at":"2026-06-21T05:01:58.422Z","avatar_url":"https://github.com/long-910.png","language":"Python","funding_links":["https://github.com/sponsors/long-910","https://ko-fi.com/long910"],"categories":[],"sub_categories":[],"readme":"# tmux-claude-status\n\n![tmux-claude-status social preview](https://repository-images.githubusercontent.com/1164363900/6febc7d4-834a-4ce2-84f0-6079096511a0)\n\n[![CI](https://github.com/long-910/tmux-claude-status/actions/workflows/ci.yml/badge.svg)](https://github.com/long-910/tmux-claude-status/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue?logo=python\u0026logoColor=white)](https://www.python.org/)\n[![tmux 3.0+](https://img.shields.io/badge/tmux-3.0%2B-1BB91F?logo=tmux\u0026logoColor=white)](https://github.com/tmux/tmux)\n[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-pink?logo=github)](https://github.com/sponsors/long-910)\n[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/long910)\n\n\u003e **お知らせ:** v0.8.0 より、リポジトリ名を `claude-tmux-status` から `tmux-claude-status` に変更しました。\n\u003e 旧プラグイン名をご利用の方は `~/.tmux.conf` を更新してください：\n\u003e ```diff\n\u003e - set -g @plugin 'long-910/claude-tmux-status'\n\u003e + set -g @plugin 'long-910/tmux-claude-status'\n\u003e ```\n\u003e また、`~/.claude/claude-tmux-status.json` が存在する場合は `~/.claude/tmux-claude-status.json` にリネームしてください。\n\nClaude Code の**使用状況**を tmux ステータスバーに表示するツールです。\nデフォルトでは **API コールを一切行いません**。\n**Claude.ai サブスクリプション**（使用率%表示）と **AWS Bedrock / API キー**（ローカル JSONL からのコスト表示）に対応しています。\n\n[English](README.md) | [日本語](README.ja.md) | [中文](README.zh.md)\n\n---\n\n## 動作原理\n\nClaude Code が実際に使用されたときのみ、API コールを行います。\n`~/.claude/projects/**/*.jsonl` の更新を監視し、Claude が idle の間はキャッシュを読み取るだけです。\n\n```\nClaude 使用中  →  JSONL 更新検知  →  API 1回  →  キャッシュ更新  →  表示\nClaude 未使用  →  キャッシュ読み取りのみ（API コールなし）  →  経過時間付きで表示\n```\n\n## 表示例\n\n**Claude.ai Pro / Max / Team / Enterprise**（Anthropic API からの使用率%）:\n```\n5h:78%(2h47m) 7d:84%!  |  [CPU/MEM]  |  11:23 2026-02-23\n```\n\n**5h 専用プラン**（週間制限なし）:\n```\n5h:78%(2h47m)  |  [CPU/MEM]  |  11:23 2026-02-23\n```\n\n**AWS Bedrock / API キー**（ローカル JSONL からのコスト表示、API コールなし）:\n```\n[cost] 5h:$14.21 day:$14.21 7d:$53.17  |  [CPU/MEM]  |  11:23 2026-02-23\n```\n\n| 表示 | 意味 |\n|------|------|\n| `5h:78%` | 5時間ウィンドウ使用率（Anthropic API から取得、Claude.ai 設定画面と同値） |\n| `(2h47m)` | 5hウィンドウのリセットまでの残り時間 |\n| `7d:84%` | 週間使用率（週間制限のないプランでは非表示） |\n| `!` | `allowed_warning`（75%超過） |\n| `X` | `denied`（制限到達） |\n| `[15m ago]` | キャッシュの経過時間（Claude 未使用時のみ表示） |\n| `[cost]` | コストモード（Bedrock/API キー時または手動切替時） |\n\n**キャッシュなし（初回）:**\n```\n[--] run: claude-usage --refresh\n```\n\n\u003e **注意:** 使用率%表示は **Claude.ai Pro プランのみで動作確認済み**です。\n\u003e Max・Team・Enterprise・Bedrock など他のプランで正しく表示されない場合は、\n\u003e [Issue を発行してください](https://github.com/long-910/tmux-claude-status/issues)。\n\n---\n\n## インストール\n\n### TPM (Tmux Plugin Manager) — 推奨\n\n`~/.tmux.conf` に追加：\n\n```tmux\nset -g @plugin 'long-910/tmux-claude-status'\n```\n\nその後 `\u003cprefix\u003e + I` でインストール。\n\n#### TPM オプション\n\n```tmux\n# すべてオプション（デフォルト値を示す）:\nset -g @claude-tmux-toggle-key    \"U\"      # \u003cprefix\u003e+U でパーセント/コスト切替\nset -g @claude-tmux-dashboard-key \"B\"      # \u003cprefix\u003e+B でダッシュボード popup を開く（tmux 3.2+）\nset -g @claude-tmux-install-hook  \"true\"   # Claude Code Stop フックを自動設定\nset -g @claude-tmux-auto-status   \"true\"   # status-right を自動設定\nset -g @claude-tmux-realtime      \"false\"  # 5分ごとの API ポーリングを有効化\nset -g @claude-tmux-cache-ttl    \"300\"    # キャッシュ有効期間（秒）\n```\n\n### GitHub Release からインストール\n\n`git clone` 不要。最新の `claude-usage` バイナリを直接ダウンロード：\n\n```bash\nmkdir -p ~/.local/bin\ncurl -fsSL https://github.com/long-910/tmux-claude-status/releases/latest/download/claude-usage \\\n  -o ~/.local/bin/claude-usage\nchmod +x ~/.local/bin/claude-usage\n```\n\n`~/.tmux.conf` に以下を追加：\n\n```tmux\n# tmux-claude-status\nset -g status-right-length 200\nset -g status-right \"#(claude-usage short) | %H:%M %Y-%m-%d\"\nbind U run-shell \"claude-usage toggle \u0026\u0026 tmux refresh-client -S\"\nbind B display-popup -E -w 82 -h 90% \"claude-usage dashboard\"\n```\n\ntmux を再読み込みし、Stop フックを設定：\n\n```bash\ntmux source-file ~/.tmux.conf\nclaude-usage --install-hook\n```\n\n初回のキャッシュ取得：\n\n```bash\nclaude-usage --refresh\n```\n\n### 手動インストール\n\nワンライナー（git 不要）：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/long-910/tmux-claude-status/main/install.sh | bash\n```\n\nまたはローカルクローンから：\n\n```bash\ngit clone https://github.com/long-910/tmux-claude-status.git\ncd tmux-claude-status\nbash install.sh\n```\n\n---\n\n## アンインストール\n\n### TPM 経由\n\n`~/.tmux.conf` からプラグイン行を削除：\n\n```tmux\nset -g @plugin 'long-910/tmux-claude-status'\n```\n\nその後 `\u003cprefix\u003e + alt + u` で TPM によるアンインストールを実行。\n\n### 手動アンインストール\n\n```bash\ncd tmux-claude-status\nbash uninstall.sh\n```\n\n以下が削除されます：\n- `~/.local/bin/claude-usage`\n- `~/.tmux.conf` の `tmux-claude-status` ブロック\n- `~/.claude/settings.json` の Stop フック\n- `~/.claude/tmux-claude-status.json`（設定ファイル）\n- `~/.claude/tmux-rate-limit-cache.json`（キャッシュ）\n\n---\n\n## 必要環境\n\n- Python 3.10+\n- tmux 3.0+\n- Claude Code\n  - Claude.ai サブスクリプション: 使用率%表示に OAuth トークンが必要\n    - **Claude Code v1.x**: `~/.claude/.credentials.json` から読み取り\n    - **Claude Code v2+（macOS）**: macOS キーチェーンから自動取得（`\"Claude Code-credentials\"` サービス）\n  - AWS Bedrock / API キー: 資格情報ファイル不要（ローカル JSONL からコスト表示）\n\n---\n\n## コマンドリファレンス\n\n| コマンド | 説明 | API コール |\n|----------|------|-----------|\n| `claude-usage` | 現在のモードで表示 | Claude 使用時のみ |\n| `claude-usage --refresh` | 強制更新 | 1回 |\n| `claude-usage toggle` | パーセント ↔ コスト 切替 | なし |\n| `claude-usage cost` | コスト表示（一時的） | なし |\n| `claude-usage long` | 詳細表示 | Claude 使用時のみ |\n| `claude-usage json` | JSON 出力 | Claude 使用時のみ |\n| `claude-usage dashboard` | インタラクティブダッシュボード | Claude 使用時のみ |\n| `claude-usage --version` | バージョン表示して終了 | なし |\n| `claude-usage --help` | ヘルプ表示して終了 | なし |\n| `claude-usage --install-hook` | Stop フックを設定 | なし |\n| `claude-usage --uninstall-hook` | Stop フックを削除 | なし |\n\n### コストモード\n\n`\u003cprefix\u003e + U`（または `claude-usage toggle`）でコスト表示に切り替え：\n\n```\n5h:$14.21 day:$14.21 7d:$53.17\n```\n\n### ダッシュボード\n\n`\u003cprefix\u003e + B`（または `claude-usage dashboard`）でフルスクリーンのダッシュボードを開きます。\npopup ウィンドウには **tmux 3.2+** が必要です。通常のターミナルでも動作します。\n\n```\n+==============================================================================+\n|                            Claude Usage Dashboard                            |\n+==============================================================================+\n|   Rate Limits                                                     [just now] |\n|                                                                              |\n|   5h:  78%  [###############.....]  reset 2h47m       (allowed_warning)      |\n|   7d:  84%  [################....]  reset 5.1d        (allowed_warning)      |\n|                                                                              |\n+------------------------------------------------------------------------------+\n|   Token Usage \u0026 Cost                                                         |\n|                                                                              |\n|               Input     Output    CacheRd    CacheWr       Cost              |\n|       5h      38.5K     127.8K      24.6M       1.3M     $14.21              |\n|    Today      38.5K     127.8K      24.6M       1.3M     $14.21              |\n|       7d      80.0K     468.9K      89.5M       5.1M     $53.17              |\n|                                                                              |\n+------------------------------------------------------------------------------+\n|   Top Projects  (7-day cost)                                                 |\n|                                                                              |\n|   my-app                    $28.34  [##########........]  53%                |\n|   claude-plugin             $14.12  [#####.............]  27%                |\n|   dotfiles                  $10.71  [####..............]  20%                |\n|                                                                              |\n+------------------------------------------------------------------------------+\n|   Provider: anthropic(auto)  |  Mode: default(no API)  |  Display: percent   |\n+==============================================================================+\n\n  [r] refresh    [w] toggle watch(30s)    [q] quit\n```\n\n| キー | 操作 |\n|------|------|\n| `r` | 即時リフレッシュ |\n| `w` | 30秒自動更新（ウォッチモード）の切替 |\n| `q` / `Esc` | 終了 |\n\n### `long` モード出力例\n\nClaude.ai サブスクリプション（Pro プランの例）:\n```\n-- Rate Limit [default(no API)] provider:auto(anthropic) ------------------\n  5h:  78% [XXXXXX..] reset:2h47m  (allowed)\n  7d:  84% [XXXXXXX.] reset:4.3d   (allowed_warning)\n  last updated: just now\n-- Token Cost [local JSONL] ---------------------------------\n  5h : in:38.5K out:127.8K cr:24.6M cw:1.3M cost:$14.21\n  day: in:38.5K out:127.8K cr:24.6M cw:1.3M cost:$14.21\n  7d : in:80.0K out:468.9K cr:89.5M cw:5.1M cost:$53.17\n```\n\nAWS Bedrock / API キー:\n```\n-- Rate Limit [default(no API)] provider:auto(other) ------------------\n  [not available] AWS Bedrock / API key — showing cost from local JSONL\n-- Token Cost [local JSONL] ---------------------------------\n  5h : in:38.5K out:127.8K cr:24.6M cw:1.3M cost:$14.21\n  day: in:38.5K out:127.8K cr:24.6M cw:1.3M cost:$14.21\n  7d : in:80.0K out:468.9K cr:89.5M cw:5.1M cost:$53.17\n```\n\n---\n\n## 更新タイミング\n\nデフォルトでは、Claude が実際に使用されているときのみ API を呼び出します。\nidle 時は古いキャッシュを `[Xm ago]` 付きで表示し、トークンを消費しません。\n\n### 設定ファイル\n\n`~/.claude/tmux-claude-status.json` を編集：\n\n```json\n{\n  \"realtime\": false,\n  \"cache_ttl\": 300,\n  \"provider\": \"auto\"\n}\n```\n\n| キー | 値 | デフォルト | 説明 |\n|------|-----|-----------|------|\n| `realtime` | `true` / `false` | `false` | Claude の状態に関わらず `cache_ttl` 秒ごとに API ポーリング |\n| `cache_ttl` | 整数（秒） | `300` | キャッシュ有効期間 |\n| `provider` | `\"auto\"` / `\"anthropic\"` / `\"bedrock\"` / `\"other\"` | `\"auto\"` | プロバイダを手動指定。`\"auto\"` は `~/.claude/.credentials.json` → macOS キーチェーン（v2+）の順で自動判定 |\n\n### リアルタイムモード（opt-in）\n\n上の設定ファイルで `\"realtime\": true` に設定してください。\n\n**リアルタイムモード時のこのツール自身の消費量試算**（claude-haiku-4-5, 約9 tokens/回）：\n\n| 期間 | API 回数 | 消費コスト |\n|------|---------|-----------|\n| 1日 | 288回 | ~$0.001 |\n| 1週間 | 2,016回 | ~$0.009 |\n| 1か月 | 8,640回 | ~$0.040 |\n\n\u003e デフォルト無効の理由: 「使用量確認ツールが余計な使用量を消費する本末転倒」を避けるためです。\n\n---\n\n## ライセンス\n\n[MIT](LICENSE)\n\n---\n\n## コントリビュート\n\nアーキテクチャ詳細・データソース・開発ガイドは [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flong-910%2Ftmux-claude-status","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flong-910%2Ftmux-claude-status","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flong-910%2Ftmux-claude-status/lists"}