steipete/CodexBar
Show usage stats for OpenAI Codex and Claude Code, without having to login.
CodexBar – 面向 macOS 的 AI 编码配额监控工具(Linux 也提供 CLI)
是什么 – 一款轻量级的 macOS 14+ 菜单栏应用(附带内建命令行工具),可实时显示您所使用的每个 AI 编码服务(OpenAI、Claude、Gemini、Copilot、Grok 等)的剩余令牌/积分数量。它还能显示服务使用周期的重置时间(每日、每周、每月),并可展示支出/积分余额。
为何你需要它
- 避免意外 – 查看配额重置倒计时,以便规划长时间的代码生成任务。
- 成本意识 – 对支持数据公开的服务,提供 API 使用支出和积分余额的内联图表。
- 实时状态 – 通过轮询提供者状态,在菜单图标上直接显示事件/故障标签。
- 隐私优先 – 重用现有会话(OAuth、API 密钥、浏览器 Cookie),从不存储密码;仅在启用提供者时读取少数已知文件。
核心功能(详见 README)
- 每个提供者一个状态项,或启用 合并图标 模式,将多个图标合并为一个带切换器的图标。
- 提供者特定的使用量仪表盘,附带重置倒计时。
- 支持 API 后端的提供者(OpenAI、Claude Admin API、OpenRouter、LiteLLM 等)的成本/使用量图表。
- 持久化的 使用与支出 视图,包含 7/30 天预测,按原生货币分组。
- 提供者状态轮询,附带事件标签。
- 可配置的刷新间隔(自适应默认值,以及固定 1 分钟至 30 分钟选项)。
- 内建 CLI(
codexbar),用于脚本和 CI(例如:codexbar cost --provider openai)。 - 支持提供者的 WidgetKit 小部件。
- 多语言本地化 UI(21 种语言)和 RTL 支持。
- 可选的配额重置通知。
- 无 Dock 图标;UI 极简,完全位于菜单栏中。
支持的提供者 – 应用内置支持超过 60 个提供者,涵盖 OpenAI、Claude、Gemini、Azure OpenAI,以及 ElevenLabs、Deepgram、Zed、JetBrains AI、AWS Bedrock、GroqCloud、LiteLLM 等小众服务。可通过文档化的 提供者创建指南 添加新提供者。
安装方法
- macOS – 从 GitHub 发布页面下载发布版,或通过 Homebrew Cask 安装:
brew install --cask codexbar - Linux – 通过 Homebrew(
brew install steipete/tap/codexbar)或 Arch AUR(yay -S codexbar-cli)安装 CLI。也提供多种架构的 tarball。 - 首次运行 – 打开 设置 → 提供者,启用您使用的服务。按需提供 API 密钥、OAuth 凭据或浏览器 Cookie。API 密钥可通过 CLI 设置,例如:
printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin
权限 – 应用可能请求:
- 完全磁盘访问(可选):用于读取 Web 服务的 Safari Cookie。
- 钥匙串访问:用于解密 Chromium Cookie 或读取存储的 OAuth 令牌。
- 文件夹/卷访问:启动外部提供者 CLI 时。 所有提示均在 README 中说明,您可在高级设置中完全禁用钥匙串读取。
开发 – 使用 Swift 6.2+ 为 macOS 14+ 构建。仓库包含打包应用、运行测试、代码检查和生成文档的脚本。同时为 macOS 和 Linux 构建 CLI 二进制文件。
相关项目 – 作者还维护 Trimmy(剪贴板运行助手)、MCPorter(Model Context Protocol 用 TypeScript 工具包)和 oracle(GPT-5 风格查询工具)。社区已为 Windows、Wayland、COSMIC、GNOME 和 Cinnamon 提供了移植版本。
以上所有信息均直接来自仓库的 README;未推断任何额外功能。
相关
- 项目
- 项目
- 项目
- 项目
- 项目