steipete/CodexBar

项目概览

该项目复用现有会话（如 OAuth 或 API 密钥）来展示使用情况，不存储密码，提供了一种注重隐私的 AI 服务用量监控方式。

项目类型

AI 工作流

部署方式

查看项目说明

License

MIT

适合谁

• 在 macOS 环境下工作，且希望在不输入密码的情况下快速了解自身 AI 编码工具额度限制的开发者。

核心能力

• 在 macOS 菜单栏中显示各提供商的使用额度限制以及距离下一次重置的倒计时。
• 提供了一个名为 codexbar 的命令行工具，可用于脚本和 CI 流程中，包含本地成本使用情况查询。
• 复用如 OAuth、设备流、API 密钥和浏览器 Cookie 等现有的提供商会话，不存储用户密码。
• 默认使用设备端解析来处理提供商的相关数据。
• 提供信用余额、Admin API 支出仪表板、提供商账单摘要，并在数据源暴露足够细节的情况下进行本地成本扫描。
• 轮询提供商状态，以在菜单中显示事件徽章，并在栏图标上显示指示器覆盖层。
• 为受支持的提供商提供 WidgetKit 桌面小组件。

限制与风险

• 桌面应用程序的完整体验需要 macOS 14 (Sonoma) 或更高版本。
• 在 Linux 环境下仅能使用捆绑的命令行工具，无法体验桌面菜单栏等图形界面功能。

如何开始

• 安装难度较低，可通过 Homebrew Cask 执行命令安装（如 brew install --cask codexbar），或直接下载应用程序，无需编写代码。安装后打开设置页面并启用所需的提供商即可。

核验依据

• GitHub 项目简介: Show usage stats for OpenAI Codex and Claude Code, without having to login.
• README: Tiny macOS 14+ menu bar app that keeps **AI coding-provider limits visible** and shows when each window resets.
• README: Download: <https://github.com/steipete/CodexBar/releases>
• README: - Bundled CLI (`codexbar`) for scripts and CI (including `codexbar cost --provider codex`, `claude`, or `both` for local cost usage); macOS and Linux CLI builds available.
• README: Arch Linux AUR package: ```bash yay -S codexbar-cli ```

内容核验时间：