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;未推断任何额外功能。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目