akitaonrails/ai-usagebar

解决的问题

ai-usagebar 提供了一种集中式的方法，让您可以直接从桌面环境监控各种 AI 编码服务与 LLM 供应商（如 Claude、ChatGPT、GitHub Copilot、DeepSeek 等）的使用配额与余额。它消除了手动检查多个供应商仪表板以确认剩余额度或 Token 的麻烦。

运作方式

此工具作为监控层，通过各种供应商 API 或读取官方 CLI 创建的本地验证文件来获取使用数据。它提供多种前端整合来显示这些数据：

• 系统小工具： 适用于 Omarchy Quattro 的原生面板、Wayland 的 Waybar 模块，以及 Windows 的系统托盘弹出窗口。
• TUI： 用于简洁概览的标签式终端用户界面 (ai-usagebar-tui)。
• 桌面整合： 支持 GNOME Shell、KDE Plasma 6 与 macOS。

它使用原子缓存与文件锁定来防止冗余的网络请求，并实现了速率限制逻辑（例如在 HTTP 429 错误后等待五分钟）以避免被供应商封锁。

目标用户

同时使用多个 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 Token，避免重复登录。