CodexBar 是面向 macOS 15 及更高版本的菜单栏 App, 用于集中展示 Codex 账户, 额度, Token 用量和实时任务状态
它可以在任务完成, 等待批准或额度变化时提醒你, 也能只在 Codex 任务运行期间自动防止系统睡眠
- 展示当前 Codex 账户和套餐
- 展示全部额度窗口, 剩余比例和重置时间
- 展示可用积分和手动重置次数
- 支持自动重置，可设置在手动重置次数过期前 15 分钟到 6 小时执行，默认提前 30 分钟；计划到点时可唤醒 Mac，并在执行前重新确认可用状态
- 可在菜单栏图标旁直接显示所选额度窗口
- 展示累计 Token, 单日峰值和连续使用天数
- 展示最长任务时长
- 通过 30 周热力图回顾每日 Token 用量
- 开启 CodexBar Hook 后可查看会话, 对话轮次, 工具调用和子 Agent 等每日统计
- 菜单栏状态点区分运行中, 等待批准和刚完成任务
- 主面板展示当前任务, 项目, 模型, 推理强度和持续时间
- 任务中心集中查看并发任务, 最近完成和最近终止记录
- 支持任务完成, 等待批准和异常会话提醒
- 只在符合条件的 Codex 任务存在时防止系统睡眠
- 可选择等待批准期间继续保持, 或同时保持屏幕常亮
- 支持最长防睡眠时间, 低电量保护和异常会话保护
- 任务结束或保护条件触发后自动恢复系统睡眠
- 作为菜单栏 App 运行, 不占用 Dock
- 支持全局快捷键, 开机启动和自动更新
- 支持简体中文和英文界面
- 可选通过 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, 通知, 防睡眠, 同步, 全部设置和问题排查 |
| 开发者指南 | 架构, 数据链路, 核心状态机, 存储, 隐私边界和开发验证 |
| 文档导航 | 文档导航 |
CodexBar 所有数据都在本地处理, 只有在开启跨设备同步功能后才会将各种汇总的数据上传到 iCloud private database
完整的数据访问, 本机存储和网络边界见 数据, 同步与隐私
Bug, 功能建议或使用问题欢迎通过 GitHub Issues 反馈