字
字节笔记本
2026年2月22日
CodexBar 0.14.0 发布:AI 编程助手额度监控工具
CodexBar 0.14.0 版本发布,新增 Antigravity 本地 Provider 支持。这款 macOS 菜单栏应用帮助开发者实时监控 OpenAI Codex、Claude Code、Cursor、Gemini 等多种 AI 编程工具的使用额度和重置时间。
项目简介
CodexBar 是一款专为 macOS 14+ 设计的轻量级菜单栏应用,由 steipete 开发维护。该项目在 GitHub 上已获得 6.2k stars。它的核心功能是让用户无需登录即可在菜单栏中查看各种 AI 编程助手的实时使用统计,包括会话额度、周限额度和重置时间。
v0.14.0 版本更新内容
Antigravity 本地 Provider
- 新增 Antigravity 语言服务器本地 Provider 支持(Claude + Gemini 配额)
- 添加实验性功能开关
- 改进计划显示和调试输出
- 优化未运行/端口错误的提示信息
- 隐藏账户切换功能
状态监控增强
- 新增 Google Workspace 事件轮询,用于监控 Gemini 和 Antigravity 状态
- 状态页面可直接打开 Workspace 状态页面
设置界面重构
- 新增 Providers 标签页
- 将 ccusage 和状态开关移至 General 标签
- 显示控制选项保留在 Advanced 标签
UI 优化
- 菜单宽度调整以支持四个 Provider 显示
- 卡片和图表自适应菜单宽度
- 优化 Provider 切换器/开关的间距
- 保持菜单打开时持续刷新
各 Provider 修复
- Gemini: 在不支持时隐藏仪表板操作
- Claude: 修复 Extra 使用额度/限制单位(分)显示;改进 CLI 探测稳定性;在 Debug 中显示 Web 会话信息
- OpenAI Web: 修复桌面端仪表板幽灵覆盖层问题(WebKit keepalive 窗口)
- Debug: 新增 debug-lldb 构建模式用于故障排查
支持的 AI 服务
CodexBar 目前支持以下 17 种 AI 编程服务:
| Provider | 认证方式 | 功能特点 |
|---|---|---|
| Codex | 本地 CLI RPC / OpenAI Web | 本地 Codex CLI + 可选 OpenAI 仪表板增强 |
| Claude | OAuth API / 浏览器 Cookie | 会话 + 每周使用额度 |
| Cursor | 浏览器会话 Cookie | 计划 + 使用 + 账单重置 |
| Gemini | OAuth 配额 API | Gemini CLI 凭证,无需浏览器 Cookie |
| Antigravity | 本地语言服务器 | 实验性,无需外部认证 |
| Droid (Factory) | 浏览器 Cookie + WorkOS | Factory 使用 + 账单 |
| Copilot | GitHub 设备流 | Copilot 内部使用 API |
| z.ai | API Token (Keychain) | 配额 + MCP 窗口 |
| Kimi | Auth Token (JWT) | 每周配额 + 5小时速率限制 |
| Kimi K2 | API Key | 基于信用的使用总额 |
| Kiro | CLI 命令 | 月度信用 + 奖励信用 |
| Vertex AI | Google Cloud gcloud OAuth | 本地 Claude 日志的 Token 成本追踪 |
| Augment | 浏览器 Cookie | 自动会话保持;信用追踪 |
| Amp | 浏览器 Cookie | Amp Free 使用追踪 |
| JetBrains AI | 本地 XML | IDE 配置的月度信用 |
| OpenRouter | API Token | 跨多提供商的信用使用追踪 |
核心功能
- 多 Provider 菜单栏: 支持按 Provider 开关,只显示你使用的服务
- 会话 + 每周计量: 显示剩余额度和重置倒计时
- 可选 Codex Web 仪表板增强: 代码审查剩余、使用明细、信用历史
- 本地成本使用扫描: Codex + Claude 最近 30 天的成本分析
- Provider 状态轮询: 事件标记显示在菜单和图标覆盖层
- 合并图标模式: 将多个 Provider 合并为一个状态项 + 切换器
- 刷新频率预设: 手动、1分钟、2分钟、5分钟、15分钟
- 内置 CLI 工具:
codexbar命令用于脚本和 CI,支持codexbar cost --provider codex|claude成本查询 - Linux CLI 支持: 通过 Omarchy 社区 Waybar 模块和 TUI
- WidgetKit 小组件: 镜像菜单卡片快照
- 隐私优先: 设备端解析,浏览器 Cookie 可选且重复使用(不存储密码)
安装方式
系统要求
- macOS 14+ (Sonoma)
GitHub Releases
下载地址:https://github.com/steipete/CodexBar/releases
Homebrew
bash
brew install --cask steipete/tap/codexbarLinux (CLI only)
bash
brew install steipete/tap/codexbar或从 GitHub Releases 下载 CodexBarCLI-v<tag>-linux-<arch>.tar.gz
首次使用
- 打开 Settings → Providers,启用你需要的服务
- 安装/登录你依赖的 Provider 源(如
codex、claude、gemini、浏览器 Cookie 或 OAuth) - 可选:Settings → Providers → Codex → OpenAI cookies(自动或手动)添加仪表板增强
菜单栏图标说明
菜单栏图标是一个双条计量器:
- 上条: 5小时/会话窗口。如果周额度缺失/用完但有信用额度,会变成更粗的信用条
- 下条: 周窗口(细线)
- 错误/过期数据会使图标变暗;状态覆盖层指示事件
隐私说明
CodexBar 不会扫描整个文件系统。它只读取一组已知位置(浏览器 Cookie/本地存储、本地 JSONL 日志),且仅在相关功能启用时进行。详细讨论和审计说明见 issue #12。
项目链接
分享: