See your Codex usage in the macOS menu bar.
| Feature | What it does |
|---|---|
| Usage View | Shows remaining Codex usage at a glance |
| Reset Time | Shows when the short window resets |
| Reset Date | Shows when the weekly window resets |
| Fast Refresh | Updates the number every minute |
| Local First | Reads local Codex session files on your Mac |
Codex Usage Menu is a small macOS menu bar app for people who use Codex often.
It shows two simple numbers in the top-right menu bar: the remaining short-window usage and the remaining weekly usage. You can see the number without opening Codex, searching logs, or checking account pages.
Use it when Codex usage matters during the work day. It helps you decide whether to start a large task now, wait for the short reset, or keep capacity for later work.
git clone https://github.com/fresh-claw/codex-usage-menu.git
cd codex-usage-menu
zsh scripts/install.shAfter install, look at the macOS menu bar.
Example:
93%@17:48 83%@04/29
This means:
| Part | Meaning |
|---|---|
93%@17:48 |
93% remains until the short window resets at 17:48 |
83%@04/29 |
83% remains until the weekly window resets on 04/29 |
zsh scripts/uninstall.shThe app reads local Codex session files from your Mac. It does not need a server, password, token, or cloud account.