看液面，就有数。The level tells the story.
菜单栏小水杯和精确百分比一起显示。点开首页，0–100 刻度让剩余额度更直观，多个额度窗口也能一并查看。A small cup and an exact percentage in your menu bar. Open the panel for a 0–100 scale and all your usage windows.
刻度液位 + 精确数字A calibrated cup + exact numbers
给认真写代码的你，一点余量感 A little peace of mind for your coding day
你的 Codex，
还剩几口？Your Codex.
How many sips left?
把剩余额度装进一只小水杯。
抬眼看菜单栏，就知道还剩多少。Your remaining quota, in a little cup.
One glance at the menu bar tells you what’s left.
不必反复打开额度页。
专心写代码，小杯子替你记着。No more reopening the usage page.
Focus on your code. The cup keeps count.
菜单栏里的小小陪伴A little company in your menu bar01 / PREVIEW
Codex Cub每 5 分钟自动刷新Refreshes every 5 minutes
剩余额度Remaining
81%
每周额度Weekly limit余量充足，继续写。◷ 下次重置◷ Next reset跟随你的额度窗口From your account limits
✧ 重置预测✧ Reset forecast非官方参考Unofficial
额度余额 ↘ 正在消耗额度Credit balance ↘ Using credits57,806
原生 macOSNative macOSSwiftUI · AppKit每 5 分钟Every 5 minutes自动更新额度Automatic usage updates留在菜单栏In your menu bar随手看，不打断A glance, not an interruption
SMALL APP, EVERYDAY COMPANY
小小一杯，
刚好装下你关心的事。A little cup.
Just the details you need.
从剩余比例到额度余额，把常用的信息放近一点。From plan limits to credit balances, keep the details close.
知道何时再来一杯。Know when it refills.
查看自己的重置倒计时，也能参考 Codex Reset Monitor 的公共重置预测。预测与实际额度分开展示，数据过期时会明确提示。See your own reset countdown alongside third-party forecasts from Codex Reset Monitor. Forecasts stay separate from account limits, with stale data clearly marked.
查看预测来源 ↗View forecast source ↗合上盖子，接着做。Close the lid. Keep going.
每次限时 2 小时。电池 ≤20%、系统高温、到时或退出后恢复正常睡眠；显示当前系统热状态。Keep awake for up to 2 hours. Normal sleep resumes at ≤20% battery, high system heat, timeout or app exit. The panel shows the current thermal state.
开启需要系统授权，使用时请保持通风Requires administrator approval. Keep your Mac ventilated.
额外额度，也心中有数。Keep track of extra credits.
余额单独显示；相邻两次刷新发现余额下降时，提示“正在消耗额度”，悬停可看减少量。首次读取、充值增加或数据过期时不误报。Credits appear separately. When the balance drops between refreshes, “Using credits” appears; hover for the decrease. A first reading, top-up or stale data won’t trigger it.
根据刷新间的余额变化判断，非实时计费状态Based on balance changes between refreshes, not live billing.
A QUICK START
三步，把小杯子放上去。Three steps to your menu bar.
- 01
下载并解压Download and unzip
下载已公证的 Mac 安装包，把 Codex Cub 拖到「应用程序」文件夹。Unzip the notarized package and drag CodexUsage.app into Applications.
- 02
准备好 CodexSet up Codex
先安装并登录本机 Codex CLI。App 通过本地 Codex 读取额度，无需在页面填写密钥。Install the Codex CLI and sign in on your Mac. The app reads limits locally; no keys to enter on this page.
- 03
打开，抬头看看Open and take a look
启动 Codex Cub，菜单栏会出现小水杯。点开查看详情，也可以在设置中启用登录时启动。Open Codex Cub to see your cup in the menu bar. Click for details and enable “Open at login” in settings if you wish.
无需在本工具里重新登录；凭据由本机 Codex 管理。安装包支持 macOS 13+，未提供 Intel 预编译版。No extra sign-in: the local Codex CLI manages your credentials. Requires macOS 13+; no prebuilt Intel package is available.
GOOD TO KNOW
先回答几个
小问题。A few things
you might wonder.
以后怎么更新？How do I update the app?
在 App 设置或菜单栏右键菜单中选择「检查更新…」，下载完成后点击安装并重启。也可开启自动检查；不会自动安装。v1.0.4 及更早的用户需要先手动安装一次新版。Choose “Check for Updates…” in settings or the menu bar’s right-click menu, then install and relaunch. Automatic checks are optional; installation remains your choice. Versions 1.0.4 and earlier need one manual upgrade first.
杯子里的水量是真实额度吗？Is the fill level real usage data?
App 里的液位来自本机已登录 Codex 的额度数据，百分比与菜单栏同步；网页上方是自动播放的演示。应用图标是固定的约八成液位插画。The app’s fill level comes from your signed-in Codex account and matches the menu bar percentage. This webpage uses simulated data. The app icon is a fixed illustration at about 81%.
重置预测是官方承诺吗？Are reset forecasts official?
不是。预测来自第三方 Codex Reset Monitor，仅供参考，不能保证实际重置时间。你自己的额度重置倒计时来自 Codex 的额度窗口。No. Third-party forecasts from Codex Reset Monitor are estimates, not guarantees. Your personal reset countdown comes from Codex account limits.
支持哪些 Mac？Which Macs are supported?
当前下载包适用于 Apple 芯片 Mac（M 系列），需要 macOS 13 或更新版本。暂未提供 Intel 安装包。The download supports Apple Silicon Macs (M series) on macOS 13 or later. No Intel package is available.
为什么打开后没有额度？Why don’t I see my limits?
先确认本机已安装并登录 Codex CLI，再点击 App 右上角刷新。缺少 CLI、读取失败或数据过期时，App 会显示相应提示。Check that the Codex CLI is installed and signed in, then click Refresh. The app reports a missing CLI, failed reads or stale data.
这是 OpenAI 官方应用吗？Is this an official OpenAI app?
Codex Cub 是独立的 macOS 小工具，与 OpenAI 无隶属关系。额度由本地 Codex 提供，第三方预测会标注来源。Codex Cub is an independent macOS utility, not affiliated with OpenAI. Limits come from local Codex; third-party forecasts are labeled with their source.
ONE MORE SIP. ONE MORE IDEA.
留点余量，
给下一个好想法。Save a little.
For your next good idea.
让小杯子，陪你把代码写完。A little cup to keep you company while you code.
下载 Mac 版 Download for Mac查看安装包 SHA-256View package SHA-256
392280e03dc0f0598ed6bbacb37b0ea1a8a004c69fb3b49920d63d5b7be72c0b