akitaonrails/ai-usagebar

解決する課題

ai-usagebar は、さまざまな AI コーディングサービスや LLM プロバイダー（Claude、ChatGPT、GitHub Copilot、DeepSeek など）の利用枠やクレジット残高を、デスクトップ環境から直接一元的に監視する方法を提供します。制限に達する前に残りのクレジットやトークンを確認するために、複数のプロバイダーのダッシュボードを手動でチェックする必要がなくなります。

仕組み

このツールは監視レイヤーとして機能し、各プロバイダーの API から利用データを取得するか、公式 CLI によって作成されたローカルの認証ファイルを読み取ります。データを表示するために、複数のフロントエンド統合を提供しています。

• システムウィジェット: Omarchy Quattro 用のネイティブパネル、Wayland 用の Waybar モジュール、Windows 用のシステムトレイポップオーバー。
• TUI: プロバイダーの概要をコンパクトに表示するタブ付きターミナルユーザーインターフェース (ai-usagebar-tui)。
• デスクトップ統合: GNOME Shell、KDE Plasma 6、macOS をサポート。

アトミックキャッシュとファイルロックを使用して冗長なネットワークリクエストを防ぎ、プロバイダーによるブロックを回避するためのレート制限ロジック（HTTP 429 エラー後に5分間待機するなど）を実装しています。

対象ユーザー

複数の AI コーディングアシスタントや LLM API を利用しており、ワークフローを中断することなく、残りの利用枠、リセットタイマー、支出状況をリアルタイムで一目で確認したい開発者やパワーユーザー向けです。

ハイライト

• 幅広いプロバイダーサポート: Claude、Codex、GitHub Copilot、Z.AI、OpenRouter、DeepSeek、DeepInfra、Kimi、Nous Research など多数のサービスと統合。
• マルチプラットフォーム: Linux (Nix, Arch など)、macOS、Windows で利用可能。
• 柔軟な表示: Waybar、Omarchy Quattro、TUI、Windows システムトレイをサポート。
• スマート通知: 利用枠が設定したしきい値（例: 97%）を超えたときにデスクトップアラートを送信。
• 認証情報の再利用: 公式 CLI（claude、gh、codex など）の既存の OAuth トークンを活用し、重複したログインを回避。