Codex Usage Menu Bar

中文 | English

一个轻量、原生的 macOS 菜单栏应用，用于显示 Codex 当前 5 小时窗口和每周窗口的剩余用量。

Codex 5h 59% · 周 94%

应用从 ~/.codex 下的本地 Codex 会话记录读取结构化的 token_count 事件。它不会读取密码、浏览器 Cookie 或 API Key，也不会通过网络发送用量数据。

这是一个非官方的社区工具。Codex 的本地事件格式未来可能发生变化。

功能

• 显示 5 小时窗口和每周窗口的剩余百分比
• 在下拉菜单中显示准确的额度重置时间
• 每 60 秒自动刷新
• 支持手动刷新和打开 Codex
• 通过用户级 LaunchAgent 登录自动启动
• 原生 AppKit 应用，无第三方依赖

系统要求

• macOS 13 或更高版本
• 已安装 Codex 桌面应用或 CLI，并在 ~/.codex 中存在本地会话记录
• Apple Command Line Tools，可通过 xcode-select --install 安装

安装

git clone https://github.com/bbosoo/codex-usage-menubar.git
cd codex-usage-menubar
make install

应用将安装到 ~/Applications/CodexUsageMenuBar.app 并立即启动。以后登录 Mac 时也会自动启动。

卸载

make uninstall

工作原理

Codex 会把限额快照记录在本地 JSONL 会话文件中。应用查找最新的 token_count 事件并读取：

• primary.used_percent 和 primary.resets_at：5 小时窗口
• secondary.used_percent 和 secondary.resets_at：每周窗口

页面显示的剩余用量为 100 - used_percent。Codex 收到新的用量快照后，菜单栏数值会在下一次刷新时更新。

隐私

所有处理均在本机完成。应用只扫描以下目录中的近期 .jsonl 文件：

• ~/.codex/sessions
• ~/.codex/archived_sessions

项目不包含数据分析或联网代码。

许可证

MIT