CodexBar 是面向 macOS 15 及更高版本的菜单栏 App，用于集中展示 Codex 账户、额度、Token 用量和实时任务状态。
它可以在任务完成、等待批准或额度变化时提醒你，也能只在 Codex 任务运行期间自动防止系统睡眠。
- 展示当前 Codex 账户和套餐
- 展示全部额度窗口、剩余比例和重置时间
- 展示可用积分和留存重置
- 支持自动重置，可设置在留存重置过期前 15 分钟到 6 小时执行，默认提前 30 分钟；计划到点时可唤醒 Mac，并在执行前重新确认可用状态
- 可在菜单栏图标旁直接显示所选额度窗口
- 展示累计 Token、单日峰值和连续使用天数
- 展示最长任务时长
- 通过 30 周热力图回顾每日 Token 用量
- 开启 CodexBar Hook 后可查看会话、对话轮次、工具调用和子 Agent 等每日统计
- 菜单栏状态点区分运行中、等待批准和刚完成任务
- 主面板展示当前任务、项目、模型、推理强度和持续时间
- 任务中心集中查看并发任务、最近完成和最近终止记录
- 支持任务完成、等待批准和异常会话提醒
- 只在符合条件的 Codex 任务存在时防止系统睡眠
- 可选择等待批准期间继续保持，或同时保持屏幕常亮
- 支持最长防睡眠时间、低电量保护和异常会话保护
- 任务结束或保护条件触发后自动恢复系统睡眠
- 作为菜单栏 App 运行，不占用 Dock
- 支持全局快捷键、开机启动和自动更新
- 支持简体中文和英文界面
- 支持为 Codex 服务配置 HTTP/HTTPS 代理
- 可选通过 iCloud 合并多台 Mac 的每日 Hook 统计
brew install --cask bob-zebedy/tap/codexbar从 GitHub Releases 下载最新版本并拖入 Applications。
- macOS 15.0 或更高版本
- 已安装并登录 Codex CLI 或安装了内置 Codex 的 ChatGPT App 或 Codex App
- 当前运行的 Codex 版本需要为
0.143.0或更高版本 - 使用实时任务等 Hook 功能时，当前运行的 Codex 版本需要为
0.145.0或更高版本 - 使用跨设备同步时，Mac 需要登录可用的 iCloud 账户
- 启动 CodexBar，在菜单栏找到 CodexBar 图标
- 左键点击图标查看账户、额度和 Token 用量
- 右键或按住 Control 点击图标打开设置、日志或退出菜单
- 在
设置 > 高级中启用 CodexBar Hook，解锁实时任务、任务类通知、防睡眠和 Hook 统计
默认全局快捷键为 ⌘⇧W，可在设置中重新录制或关闭。
| 文档 | 内容 |
|---|---|
| 用户指南 | 安装、主面板、Hook、通知、防睡眠、同步、全部设置和问题排查 |
| 开发者指南 | 架构、数据链路、核心状态机、存储、隐私边界和开发验证 |
| 文档导航 | 文档导航 |
Hook 原始事件和实时任务在本机处理。开启跨设备同步后，日级 Hook 聚合会上传到 iCloud private database。账户和用量通过本机 Codex app-server 获取，由 Codex 连接服务端；更新检查使用 Sparkle。
完整的数据访问、本机存储和网络边界见 数据、同步与隐私
Bug、功能建议或使用问题欢迎通过 GitHub Issues 反馈。