UsageInsight

An unofficial native macOS menu-bar utility that shows your remaining Codex allowance and the next reset time.

UsageInsight is an independent open-source project and is not affiliated with or endorsed by OpenAI.

The menu-bar title looks like this:

66% · Aug 7 09:30

Left-click it to switch between the absolute reset date and a live countdown:

66% · 6d 3h

Right-click for usage details, manual refresh, the Usage Dashboard, Codex CLI selection, and Quit.

Early-reset announcement monitor

OpenAI sometimes resets Codex/ChatGPT quotas earlier than the scheduled time, and the community tracks the announcements — most notably Tibo (@thsottiaux), who posts reset notices on X. UsageInsight now watches these public signals and warns you when an early reset is announced, so you can adjust your usage plan before it happens.

When an early reset is detected the menu-bar title gains an orange ⚠ marker:

⚠ 66% · Aug 7 09:30

Left-click it to see the full details (who announced it, the announced reset time vs your scheduled reset, the announcement text, and aggregator notes) and jump to the original post. The right-click menu shows the same information plus a Reset Monitor submenu with:

• Monitor reset announcements — enable/disable the feature
• Refresh Announcements Now
• Edit Monitored Accounts… — change which accounts are watched
• source health and last update time

Data sources (all public, no API key, no cookies):

Source	What it provides
Bluesky mirrors of the watchlist accounts (app.bsky.feed.getAuthorFeed)	Raw posts with timestamps — default accounts are two mirrors of Tibo: thsottiaux-mirr.selfhosted.social, thsottiaux-bot.eurosky.social
WillTiboReset (willcodexquotareset.com/api/forecast + committed output/prediction.json)	Tibo's posts, structured completed/pending reset announcements, survival-model reset probabilities, latest-reset history
CodexResetMonitor (snapshot.json)	Administrator-approved reset announcements with canonical X URLs, OpenAI status incidents

Detection is conservative: an announcement only flags the UI as early when it is fresh (≤ 4 days), belongs to your current quota window, and names a reset more than one hour earlier than your scheduled reset. The monitor refreshes every 10 minutes, is best-effort (a failing source never breaks usage display), and never uploads anything. No X API token is needed.

Other people have definitely hit this too — early/off-cycle resets are a documented community phenomenon. Besides the two projects above there are trackers such as codexresetradar.com and codexresets.com; WillTiboReset's history records resets on Jul 25/26/28, Aug 1 and Aug 10, 2026 (several "Tibo confirmed on X").

Requirements

• macOS 13 or newer
• The Codex CLI installed
• Codex signed in with a ChatGPT account (codex login)

The app talks to the local codex app-server process and calls its documented account/rateLimits/read method. Codex owns authentication and token refresh; this app never reads, stores, or logs your ChatGPT tokens.

Build and run

make test
make live-check
make announcement-check   # fetch & print current reset announcements
make build
open "build/UsageInsight.app"

make live-check prints the current percentage, window, reset date, and countdown through the same Codex connection used by the app. make announcement-check prints the latest reset announcements the monitor would surface. The generated app is ad-hoc signed and lives at build/UsageInsight.app. Drag it to /Applications if you want to keep it there.

For development, open Package.swift in Xcode or use Swift Package Manager from Terminal. make test runs a dependency-free self-check for response decoding, menu-bar date/countdown formatting, and the announcement-detection logic, so full Xcode is not required.

Behavior

• Refreshes usage on launch and every five minutes; checks reset announcements on launch and every ten minutes.
• Updates a visible countdown every 30 seconds.
• Shows remaining capacity in green at 50% or more, orange at 20–49%, and red below 20%.
• When an early reset is announced, the title shows an orange ⚠ marker and left-click shows the announcement details instead of toggling the reset display (use the right-click menu to toggle).
• Remembers whether you prefer reset date or countdown.
• Finds Codex from CODEX_PATH, your shell PATH, common install locations, and nvm installations.
• Lets you locate the Codex executable manually from the right-click menu.
• Shows all returned primary and secondary limit windows in the right-click menu.
• The Reset Monitor right-click submenu shows the monitor's on/off state, a manual refresh, editable watched accounts, the last update time, and source health (a failing source is reported there and never hides usage data).

Troubleshooting

If the title shows GPT !, right-click it to see the error.

• Codex CLI was not found: choose Locate Codex CLI…, or install Codex and reopen the app.
• No ChatGPT usage window is available: run codex login and sign in with ChatGPT. API-key-only sessions do not expose a ChatGPT plan allowance.
• The response format changed: update Codex first, then rebuild this app.
• The Reset Monitor submenu lists a source error: the announcement sources are best-effort and independent — a single failing source is normal (e.g., a mirror account being rate-limited). Check Refresh Announcements Now and the source health line; usage display is never affected.
• The ⚠ marker won't disappear: the monitor keeps flagging a fresh early-reset announcement for up to 4 days. Once the quota actually resets, your usage window refreshes; you can also turn the monitor off in Reset Monitor → Monitor reset announcements.

Data-source note

This app displays the ChatGPT rate-limit data returned by the local Codex app-server. It is not the OpenAI Platform Usage API, which reports API-organization activity and costs. Availability and fields can vary by ChatGPT plan and workspace.