字节笔记本

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 仪表板增强
ClaudeOAuth API / 浏览器 Cookie会话 + 每周使用额度
Cursor浏览器会话 Cookie计划 + 使用 + 账单重置
GeminiOAuth 配额 APIGemini CLI 凭证,无需浏览器 Cookie
Antigravity本地语言服务器实验性,无需外部认证
Droid (Factory)浏览器 Cookie + WorkOSFactory 使用 + 账单
CopilotGitHub 设备流Copilot 内部使用 API
z.aiAPI Token (Keychain)配额 + MCP 窗口
KimiAuth Token (JWT)每周配额 + 5小时速率限制
Kimi K2API Key基于信用的使用总额
KiroCLI 命令月度信用 + 奖励信用
Vertex AIGoogle Cloud gcloud OAuth本地 Claude 日志的 Token 成本追踪
Augment浏览器 Cookie自动会话保持;信用追踪
Amp浏览器 CookieAmp Free 使用追踪
JetBrains AI本地 XMLIDE 配置的月度信用
OpenRouterAPI 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/codexbar

Linux (CLI only)

bash
brew install steipete/tap/codexbar

或从 GitHub Releases 下载 CodexBarCLI-v<tag>-linux-<arch>.tar.gz

首次使用

  1. 打开 Settings → Providers,启用你需要的服务
  2. 安装/登录你依赖的 Provider 源(如 codexclaudegemini、浏览器 Cookie 或 OAuth)
  3. 可选:Settings → Providers → Codex → OpenAI cookies(自动或手动)添加仪表板增强

菜单栏图标说明

菜单栏图标是一个双条计量器:

  • 上条: 5小时/会话窗口。如果周额度缺失/用完但有信用额度,会变成更粗的信用条
  • 下条: 周窗口(细线)
  • 错误/过期数据会使图标变暗;状态覆盖层指示事件

隐私说明

CodexBar 不会扫描整个文件系统。它只读取一组已知位置(浏览器 Cookie/本地存储、本地 JSONL 日志),且仅在相关功能启用时进行。详细讨论和审计说明见 issue #12。

项目链接

分享: