Remaining usage comes first
A slim rail keeps the useful percentage visible. Hover for reset timing, or click to pin the detail card.
Open-source Windows companion
Codex usage,where you work.
Usage Overlay keeps your remaining Codex allowance and reset time beside the desktop app, without modifying Codex, reading conversations, or owning your authentication.
Preview project · Windows 10/11 x64 · MIT licence · Executable currently unsigned
Usage OverlayOpen-source Windows companion
Live state
- Runs separately
- No Codex modification
- Rate limits only
- No conversation access
- Local by design
- No telemetry or ads
- Public proof
- CI, CodeQL and source
Designed for focus
One useful number. Detail when you ask for it.
The interface stays quiet until you need the reset time, connection status, or a closer look at the current limit.
Honest when data is missing
The rail shows a neutral “--” instead of presenting an old percentage as current after a failed connection.
Positioned around your work
Choose either edge, nudge the rail, drag it anywhere, follow Codex across monitors, or pause it for 15 minutes.
Light, dark or follow Codex
Use a fixed theme or let the overlay infer the active Codex surface without saving or logging screen content.
A narrow connection
Built beside Codex, not inside it.
Codex CLI keeps account ownership and network access. Usage Overlay requests rate-limit metadata through the documented App Server surface and renders it in a separate WPF process.
Read App Server documentation- 01
Start App Server
Usage Overlay launches codex app-server --stdio as a child process.
- 02
Read the current limit
It requests account/rateLimits/read through newline-delimited JSON-RPC.
- 03
Listen for updates
account/rateLimits/updated keeps the rail current, with polling as a fallback.
- 04
Render in WPF
The native non-activating window updates without taking keyboard focus from Codex.
Native settings
Control the behavior without editing a file.
General, Visibility, Position, Appearance, and Connection controls live in one native window. Save and Cancel are explicit, theme choices preview safely, and validation keeps impossible thresholds or paths from being written.
- Only in Codex or across Windows
- Hide while Codex is fullscreen
- Left, right or drag-anywhere placement
- Multi-monitor tracking
- Pause for 15 minutes
- Windows startup and tray recovery
- Threshold and refresh validation
- Restore defaults before saving
Open-source preview
Review the source before you trust the utility.
The repository includes the architecture, privacy policy, security guidance, 11 dependency-free specifications, CI, CodeQL, build scripts, release validation, and the MIT licence.
Release status
No completed GitHub Release or signed installer is claimed yet. The current executable is unsigned, so this page points to the source and documentation rather than presenting a download as ready.
Go deeper
See the decisions behind the product.
The case study covers the product tradeoffs, App Server connection, privacy boundary, testing, and open-source preparation.