CodexBar

在 macOS 菜单栏查看 Codex 状态

简体中文 | English

功能 | 安装 | 隐私 | 运行架构 | 协议

CodexBar 是 macOS 菜单栏 App，可查看 Codex 账户、额度、Token 用量和实时任务状态。

功能

账户与额度

• 查看账户、套餐、积分，以及各额度窗口的剩余比例和重置时间
• 在菜单栏直接显示关注的额度
• 查看留存重置和到期时间，可在到期前自动使用

任务进展

• 查看项目、模型、推理强度、任务耗时和 Token 用量
• 实时显示执行状态、等待回应、任务进度和最近事件
• 在任务中心查看并发任务，以及最近完成、失败或中断的任务

使用统计

• 查看累计用量、单日峰值、连续使用天数和最长任务时长
• 通过热力图查看每日 Token 用量和活动统计
• 通过 iCloud 汇总多台 Mac 的使用记录

通知与任务流光

• 接收任务完成、等待回应、额度变化和保护提醒
• 选择需要的通知类型、音效和任务触觉反馈
• 用屏幕顶部的任务流光显示状态变化，支持自定义外观

防睡眠

• 任务运行时自动防止 Mac 睡眠，结束后恢复正常睡眠
• 可在等待回应时继续保持唤醒，或同时保持屏幕常亮
• 支持防睡眠时限、低电量保护和异常任务保护

安装

Homebrew

brew install --cask bob-zebedy/tap/codexbar@5

DMG

从 GitHub Releases 下载最新版本，将 CodexBar 拖入 Applications。

运行要求

• macOS 15.0 或更高版本
• 已安装 Codex CLI 0.162.0 或更高版本并使用 OpenAI 登录
• 跨设备同步需要登录可用的 iCloud 账户

隐私

CodexBar 在本机处理活动原始事件和实时任务。开启跨设备同步后，会将按天汇总的活动数据和 Token 用量记录上传到 iCloud 私有数据库。

反馈

通过 GitHub Issues 报告 Bug、提出功能建议或询问使用问题。

许可证

GNU General Public License v3.0