TokenBar

TokenBar

Claude Code、Codex、Copilot、Windsurf、Cursor、Gemini、Kiro、GLM、Kimi、Amp…（または任意の AI）の使用上限とリセット時刻を、
Mac、Windows、Linux、iPhone、Android、Apple Watch、Wear OS など、どこでも LED ディスプレイで確認できます。

英語 · ポルトガル語

ウェブサイトと API ドキュメント： https://chaconlucas.github.io/tokenbar/

---

インストール

数値を収集するのはコンピューターです。 スマートフォンやウォッチは、Wi-Fi 経由で送られてくる情報を表示するだけなので、まずは必ずコンピューターから始めてください。

	デバイス	方法
コンピューター	Mac（macOS 15+）	curl -fsSL https://raw.githubusercontent.com/ChaconLucas/tokenbar/main/scripts/install-mac.sh | sh
	Homebrew 経由の Mac	brew install --cask chaconlucas/tokenbar/tokenbar
	Windows 10/11	Releases の TokenBar-Windows-setup.exe。SmartScreen の警告が表示された場合は、詳細情報 → 実行 を選択してください
	winget 経由の Windows	winget install ChaconLucas.TokenBar（Microsoft の審査待ち）
	Linux	ソースからビルドしてください。ソースからのビルドを参照してください
スマートフォンとウォッチ	iPhone（iOS 17+）	Xcode を搭載した Mac に iPhone を接続し、curl -fsSL https://raw.githubusercontent.com/ChaconLucas/tokenbar/main/scripts/install-ios.sh | sh を実行してください。sh の後に -s -- --auto を追加すると、Mac が自動で更新を確認して適用します
	Apple Watch（watchOS 10+）	iPhone アプリに付属しています。iPhone → Watch アプリ → TokenBar → インストール
	Android 8+	Releases の TokenBar-Android.apk（「不明なアプリのインストール」を許可してください）
	Wear OS 3+	Releases の TokenBar-WearOS.apk。adb でインストールしてください（手順）
追加機能	VS Code	拡張機能で TokenBar を検索してください（Marketplace、ID は chaconlucas.tokenbar）
	Raycast	ソースから実行：cd raycast && npm install && npm run dev（詳細）
	Stream Deck	Releases の TokenBar-StreamDeck.streamDeckPlugin をダブルクリックしてください（詳細）
	プラグイン	Claude Code：claude plugin marketplace add ChaconLucas/tokenbar && claude plugin install tokenbar@tokenbar。Codex と Gemini CLI：プラグイン（MCP サーバー、/tokenbar、80% で警告）
	CLI + MCP	curl -fsSL https://raw.githubusercontent.com/ChaconLucas/tokenbar/main/scripts/install-cli.sh | sh（Node 18+）。Claude Desktop：Releases の TokenBar.mcpb をダブルクリックしてください。Cursor、VS Code、Windsurf、Zed、Gemini、Goose など：AI にインストール（ワンクリック、または --add-to <tool>）

更新： Mac、Windows、Android では、アプリ内に更新ボタンが表示されます。iPhone（およびそのウォッチアプリ）は install-ios.sh をもう一度実行するか、--auto で自動更新できます。VS Code は Marketplace 経由で更新されます。

Mac にブロックされました（「開けません」「未確認の開発元」「破損しています」）か？

TokenBar はまだ Apple の公証を受けていません（有料の開発者アカウントが必要です）。そのため、アプリをブラウザーから入手した場合、macOS は初回起動をブロックします。次のいずれかの方法で解決できます。

1. 上記のコマンドでインストールしてください。 ターミナルからダウンロードすると、警告は表示されません。
2. 一度だけ許可する： TokenBar を開こうとする → システム設定 → プライバシーとセキュリティ → 下にスクロール → このまま開く → Mac のパスワードを入力。
3. 「破損しています」と表示される場合： ターミナルで xattr -dr com.apple.quarantine /Applications/TokenBar.app を実行し、もう一度開いてください。

"TokenBar が Claude Code の認証情報に保存された機密情報の使用を要求しています" というプロンプトはブロックではなく、ログイン情報を読み取るものです（VS Code パネル）。常に許可 を選択してください。

または、AI に頼んでください。 Claude Code、Codex、またはターミナルを使える AI を開き、次のように伝えてください。

https://github.com/ChaconLucas/tokenbar/blob/main/INSTALL.md を読んで、TokenBar をインストールしてください。

INSTALL.md は AI 向けに書かれています。使用しているデバイスを確認し、コマンドを実行して、必要な場合（権限の許可、スマートフォン、ウォッチ）にだけ操作を求めます。

---

機能

Mac

• LED のデバイスウィンドウ（拡大、縮小、または全画面表示）と、全画面アプリを含め、常に最前面に表示されるフローティングのMini。
• MOSTRAR A %（％を表示）：BARRA（メニューバーに％付きの小さな LED バーを表示）、NOTCH（カメラの周囲に黒いピルを表示し、ホバーすると開く）、またはOS DOIS（両方）。
• メニューバーをクリックすると、ガラス風ボタン（macOS 26 の liquid glass）を備えた概要が開きます。デバイス、Mini、Ajustes（設定）、更新、終了を操作できます。
• ウィジェット（小、中、大）とコントロールセンターのコントロール（macOS 26）：TokenBar、Claude、Codex、フローティング、デバイス。
• 4 つのタブがあるAjustes：GERAL（言語、表示内容、色）、IAS（AI）、APARELHOS（スマートフォンとウォッチ）、SERVIDOR（ローカル API、Webhook、サーバー）。Primeiros passos（はじめに）ガイドに沿って、すべてを手順どおりに接続できます。

Windows と Linux — 同じ LED デバイス、フローティングの Mini、システムトレイの 12 ドットリング、はじめにガイドを利用できます（アプリは desktop/ にあり、Tauri でビルドされています）。

iPhone

• 横向きで全画面表示され、画面は常時オン。使用制限を表示するデスククロックです。
• ホーム画面とロック画面のウィジェット（プリセットとカスタムウィジェット。「一度に 1 つ」では、タップして AI を切り替えます）。
• ロック画面とDynamic Island（搭載 iPhone のみ）のLive Activity。AI とウィンドウを切り替えるボタンもあります。
• コンピューターとペアリングする内蔵 QR スキャナー（ESCANEAR QR）と、アップデートが公開されたとき、または無料アカウントのアプリの有効期限が切れそうなときのお知らせ。

Apple Watch — アプリ（TODOS / CLAUDE / CODEX、5H / 7D、または Digital Crown を回して切り替え）、文字盤のコンプリケーション、Smart Stack カード（watchOS 11 以降では Live Activity に加え、制限が近いときやリセット間近のときに表示されるウィジェット）。

Android と Wear OS — 横向き表示のスマートフォン、ホーム画面ウィジェット、アラート、アプリ内アップデートに対応しています。Wear OS ウォッチはスマートフォンの有無にかかわらず使用できます。単独で使う場合は、コンピューターに表示される 6 桁のコードを入力してください（Mac：Ajustes → APARELHOS → WEAR OS SEM CELULAR）。文字盤のコンプリケーションにも対応しています。Google サービスのない Huawei では QR スキャンが機能しないため、代わりにリンクを貼り付けてください。

AI

• Claude Code はターミナルのステータスラインから接続できます（Ajustes → IAS の CONECTAR をワンクリック）。または、VS Code パネルを使う場合は、Claude Code のログインを利用します。
• Codex：ターミナル、VS Code、Codex アプリから自動的に接続します。
• GitHub Copilot：オプトイン（毎月のプレミアムリクエストを gh auth token 経由で取得）。
• Windsurf：自動的に接続します。
• Cursor、Gemini CLI、Kiro：各サービスに保存済みのログイン情報を使ってオプトインできます（Gemini は Workspace / Code Assist アカウントのみ）。
• GLM（Z.ai）、MiniMax、Kimi Code、OpenRouter、Factory Droid、Amp：API キーを設定 → AIsに貼り付けます（Mac ではキーチェーンに保存されます）。
• そのほかの AI は、小さな JSON ファイルを使って接続できます：docs/providers.md。

そのほか

• **言語：**ポルトガル語と英語に対応し、AUTO / PT / ENを切り替えられます（AUTO はシステム設定に従います）。
• **ウィンドウ：**5 時間、7 日間、または両方を同じ画面に表示します。使用量に応じて背景が塗りつぶされます。23％使うと、画面の 23％が点灯します。
• ウィンドウが80％、95％を超えたとき、およびリセット時にアラートを表示します（iPhone の通知はウォッチにも反映されます）。
• **カスタマイズ：**AI ごとの色、テキストとタイマーの色、使用量に応じた色、85％から赤にする設定、丸または四角のドット、明るさ。

---

API と開発者向け情報

• アプリ実行中のローカル API（Mac、Windows、Linux）：http://localhost:41777/v1/usage。localhost からのみアクセスできます。実際のポートは ~/.tokenbar/api.json にあります。
• CLI tokenbar：ターミナルにバーを表示します。シェルプロンプトや tmux では tokenbar --prompt、スクリプトでは tokenbar get claude 5h を使えます。アプリなしでも動作します。
• MCP サーバー tokenbar-mcp：Claude Code、Codex、Cursor で長いタスクの前に check_budget を呼び出せます。
• Webhook は 80%／95%／リセット時に通知します（Slack と Discord には文章で、それ以外には JSON を送信します）。
• アプリを使わずに読み取るには ~/.tokenbar/snapshot.json を使います。AI を追加するには ~/.tokenbar/providers/*.json を使います。

curl -s http://localhost:41777/v1/usage

スキーマと使用例（curl、JavaScript、Python、starship、tmux、zsh）：docs/api.md。

---

仕組み

                          Wi-Fi (Bonjour)                       WatchConnectivity / Wear OS
 Computer ─────────────────────────────────────► iPhone / Android ─────────────────────► Apple Watch / Wear OS
 (Mac, Windows, Linux)                             widgets, Lock Screen,                  complications
  │ Claude Code: copy of the statusline (or login)  Live Activity
  │ Codex: ~/.codex/sessions · Windsurf · Copilot · Cursor · Gemini · Kiro · GLM · MiniMax · Kimi · OpenRouter · Droid · Amp
  │ any AI: ~/.tokenbar/providers/*.json
  │
  └──── PUT ────► server (optional) ◄── GET ──── phones and watches, away from home

1. コンピューターがデータを収集します。 Claude Code は上限値を statusline に渡すだけです。TokenBar は小さなスクリプト（~/.tokenbar/claude-tee.sh）をインストールし、データのコピーを保存したうえで、以前から使っていた statusline を変更せずに実行します（settings.json のバックアップも作成します）。Codex は上限値を ~/.codex/sessions に書き込みます。
2. ローカルネットワーク上でアナウンスします（_tokenbar._tcp）。ペアリングキーを持つデバイスにのみ応答します。
3. 同じ Wi-Fi 上のスマートフォンが自動的に検出し、数値をウォッチに渡します。
4. 任意のサーバー： コンピューターからサーバーにもデータを送信し、スマートフォンでは Wi-Fi とサーバーのうち新しい数値を使用します。

プライバシー

• コード、プロンプト、会話がコンピューターの外に送信されることはありません。 送信されるのはパーセンテージ、リセット時刻、読み取りからの経過時間のみです。
• Wi-Fi： コンピューターはペアリングキーを送信したデバイスにのみ応答します。アナウンスにはキーの先頭 8 文字のみが表示されます。
• ローカル API： 127.0.0.1 のみで待ち受け、その他の Host ヘッダーは拒否します。
• ログイン情報： Claude Code のログイントークンは Anthropic にのみ送信され、GitHub トークン（Copilot）は GitHub にのみ送信されます。どちらも読み取り専用で、デフォルトでは無効です。
• サーバー： キーそのものではなく、キーの sha256 と最新のスナップショットを保存します。
• QR コードを知っている人は誰でも数値を確認できます。 公開しないでください。

既知の制限事項

• iPhone には Xcode を搭載した Mac が必要です。 無料の Apple アカウントではアプリの有効期間が 7 日間です（install-ios.sh または --auto で更新してください）。
• macOS： 公証されていません（「Mac がブロックしましたか？」のボックスを参照）。サンドボックス化されていないため、Mac App Store では配布できません。
• Linux： パッケージはまだありません。ソースからビルドしてください。
• Claude Code： ログイン情報の読み取りが有効でない限り、数値は Claude Code のセッション実行中に（statusline 経由で）更新されます。
• 非公式エンドポイント： Claude のログイン情報の読み取りと Copilot は、公開ドキュメントのないエンドポイントを使用しており、変更される可能性があります。
• ウィジェット： iOS と watchOS では、およそ 15 分ごとに更新されます。

トラブルシューティング

症状	対処方法
スマートフォン：「Mac não encontrado no Wi-Fi」（Mac が見つかりません）	同じ Wi-Fi に接続していますか？ iPhone で ローカルネットワーク がオンになっていますか（設定 → プライバシーとセキュリティ → ローカルネットワーク → TokenBar）？ コンピューターのファイアウォールで TokenBar が許可されていますか？
スマートフォン：「O Mac recusou a chave」（キーが拒否されました）	QR コードをもう一度スキャンしてください。
Claude が表示されない	設定 → IAS → CLAUDE CODE → 接続 を選択し、ターミナルの Claude Code でメッセージを送信してください。
VS Code パネル内の Claude	ステータスラインはそこで動作しません。設定 → IAS で VS CODE パネル をオンにするか、デバイスの下に表示されるヒントの オンにする をクリックしてください。macOS の確認画面が一度表示されます：「常に許可」を選択してください。
Codex が表示されない	Codex を一度使ってください。制限は最初の返信とともに取得されます。
VS Code 拡張機能が制限モードになっている	これは解決済みです。拡張機能は信頼されていないワークスペースでも動作します。
Watch：「整合性を検証できませんでした」	Watch で開発者モードをオンにしてください（設定 → プライバシーとセキュリティ）。
Dock のアイコンが空白になる	killall Dock を実行してください。解決しない場合は、Mac を再起動してください。

---

ソースからビルドする

Mac、iPhone、Apple Watch（Xcode 26 以降、brew install xcodegen）：

git clone https://github.com/ChaconLucas/tokenbar.git && cd tokenbar
printf 'DEVELOPMENT_TEAM = ABCDE12345\nTB_BUNDLE_PREFIX = com.yourname\n' > Config/Signing.local.xcconfig   # your Team ID; git ignores this file
xcodegen generate && open TokenBar.xcodeproj

スキーム：TokenBarMac（Mac）、TokenBar（iPhone。Watch アプリも含みます）、TokenBarWatch。iPhone と Watch では 開発者モード が必要です。初回起動時に ローカルネットワーク を許可し、設定 → デバイス の QR コードでペアリングしてください。

Windows と Linux（Rust および Node 18 以降。Linux ではさらに sudo apt install libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev build-essential）：

cd desktop && npm install && npx tauri build    # installers in src-tauri/target/release/bundle/

Android と Wear OS（JDK 17 および Android SDK）：

cd android
echo "sdk.dir=$HOME/Library/Android/sdk" > local.properties
JAVA_HOME=/opt/homebrew/opt/openjdk@17 ./gradlew :app:assembleDebug :wear:assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk                # phone
adb -s <watch> install wear/build/outputs/apk/debug/wear-debug.apk   # watch

オプションのサーバー（外出先で数値を確認する場合）

サーバーがない場合、スマートフォンの情報が更新されるのはコンピューターと同じ Wi-Fi に接続しているときだけです。Cloudflare（Worker + D1）に無料で独自のサーバーをデプロイできます。

cd server && npm install && cp wrangler.example.toml wrangler.toml
npx wrangler login
npx wrangler d1 create tokenbar          # copy the database_id into wrangler.toml
npx wrangler d1 execute tokenbar --remote --file=schema.sql
npx wrangler deploy                      # prints https://tokenbar.<your-account>.workers.dev

アドレスを 設定 → サーバー → アドレス（Windows／Linux：⚙）に貼り付け、スマートフォンで QR コードをもう一度スキャンしてください。コンピューターは数値が変わったとき、または 10 分ごとにデータを送信します。

構成

App/macOS    Mac app: collector, Wi-Fi server, notch island, Mini, settings, local API, webhooks
App/iOS      iPhone app: full screen, Live Activity, guide and QR scanner
App/watchOS  Apple Watch app
Shared/      model, LED display, theme, languages, Wi-Fi client, server API
Widget/      widgets, complications, Control Center and Live Activity (Mac, iPhone, Watch)
android/     Android phone (app), Wear OS (wear) and shared code (core)
desktop/     Windows and Linux app (Tauri)
vscode/      VS Code extension
raycast/     Raycast extension
streamdeck/  Stream Deck plugin
cli/         `tokenbar` CLI and `tokenbar-mcp` server
server/      optional Cloudflare Worker + D1
scripts/     installers (Mac, iPhone, CLI) and release
docs/        images, API and providers docs

ライセンス

MIT。詳しくは LICENSE をご覧ください。

TokenBar は独立したプロジェクトであり、Anthropic、OpenAI、GitHub、または Windsurf の開発元とは提携していません。「Claude」、「Claude Code」、「Codex」、「Copilot」、「Windsurf」は、それぞれの所有者の商標です。