作った理由
私はコーディング用のプランをいくつも契約していて、それぞれ計り方が違います。こっちは5時間の利用枠、あっちは週の上限、また別のところは前払いの残高。次のタスクをどのエージェントに回すか決めるために5つのダッシュボードを開くのはばかげていました。今はバーをひと目見ればわかります。
どこで作業していても
同じRustのコアがすべてのフロントエンドにデータを渡すので、どこで見ても数字は一致します。
ターミナルUI
ai-usagebar-tui：プロバイダーごとのタブ、60秒ごとの更新、設定のオーバーレイ付き。
macOSのメニューバー
有効にしたすべてのプロバイダー、ペースの目印、リセット時刻を表示するネイティブのポップオーバー。
Windowsのトレイ
通知領域のアイコンとWebView2のポップオーバー。Scoopでインストールできます。
KDE Plasma 6
プロバイダーのタブ付きのplasmoid。アプレットごとに別のプロバイダーを表示できます。
やってくれること
壁にぶつかる前に通知
クォータの利用枠が97%を超えるとデスクトップ通知、100%で緊急の通知、ためておいたリセットクレジットが切れる48時間前にも警告します。しきい値は変更できます。
アカウントを自動で見つける
ai-usagebar detectは、マシンにすでに認証情報があるプロバイダーをすべて有効にします。読むのはローカルのファイルとキーチェーンだけで、ネットワークには出ません。
最後に取れた数字を表示し続ける
ネットワークが失敗しても前回のデータを画面に残します。HTTP 429を返したプロバイダーには5分間アクセスしません。
複数アカウント
名前を付けたClaude、Codex、OpenRouterのアカウントを並べて、それぞれ別の項目として表示します。
claudebarの置き換えにそのまま使える
同じWaybar JSON、フラグ、Pangoのツールチップ、Omarchyのテーマ検出、ロック付きのOAuth更新。
スクリプトから使える
ai-usagebar usage --jsonは、すべてのプロバイダーのクォータとリセット時刻を1つのドキュメントとして出力します。
24のプロバイダー
コマンドラインとTUIはすべてに対応しています。デスクトップでの対応は連携先によって違うので、READMEの表を見てください。
- Claude
- Anthropic API
- Codex
- GitHub Copilot
- Z.AI
- OpenRouter
- DeepSeek
- Kimi
- Kilo
- Novita
- Moonshot
- Grok
- SuperGrok
- Grok Bot
- Antigravity
- Cursor
- MiniMax
- Kiro
- Nous Research
- OpenCode Go
- Command Code
- Ollama Cloud
- OrcaRouter
- Model Studio
インストール
プラットフォームを選んでください。Omarchy Quattroではバイナリとプラグインの両方が必要です。
omarchy pkg aur add ai-usagebar-bin && omarchy plugin add https://github.com/akitaonrails/ai-usagebar.git --enableyay -S ai-usagebar-bin # prebuiltyay -S ai-usagebar # from sourcecargo binstall ai-usagebar # prebuiltcargo install ai-usagebar # from sourcenix profile install github:akitaonrails/ai-usagebarscoop bucket add akitaonrails https://github.com/akitaonrails/scoop-bucketscoop install ai-usagebarあとは使っているものを有効にして、表示するだけです。
ai-usagebar detect # enable providers you already have credentials forai-usagebar usage # every quota and reset timeai-usagebar-tui # the terminal UI