Codex Usage Monitor
A compact always-on-top Windows widget that turns the usage information exposed by Codex App Server into clear quota windows, reset times and account-status feedback.
// Live monitoring
Usage windows without opening the main client
Dynamic quotas
Displays every limit window returned by the account, including five-hour and weekly windows when available.
Reset
Shows remaining percentage, reset time and a live countdown for each detected window.
Account context
Surfaces the plan and credit information returned by the service without storing login credentials.
Automatic refresh
Refreshes every minute and reacts to rate-limit notifications published by App Server.
// Local integration
A protocol client, not an interface scraper
- 01Codex CLIResolve the installed executable
- 02App Serverstdio / JSONL
- 03WPF widgetParse and present supported fields
Privacy choices
- No UI or browser scraping
- No direct authentication-file access
- No complete App Server payload logs
- Credentials remain managed by Codex
Resilient integration
- Nullable and missing fields tolerated
- Protocol parsing isolated from the UI
- Deterministic parser tests
- Optional live probe without email output
// Windows experience
A small widget designed to stay out of the way
Compact shell
Transparent rounded window, draggable layout and optional always-on-top behaviour.
Preferences
Opacity, corner radius, screen position and startup behaviour can be configured locally.
Tray
Runs from the notification area and can be recalled without duplicating the process.
Autostart
Optional per-user Windows startup without requiring administrator privileges.
// Scope & requirements
Requirements and evolution boundaries
Current requirements
- Windows 10/11 x64
- .NET Desktop Runtime 10
- A compatible Codex CLI installation
- A ChatGPT account authenticated in Codex
Service-dependent data
- Windows vary by account and plan
- Absolute remaining token counts may be unavailable
- App Server protocol may evolve
- No public support or release channel yet
// Availability
Documented today, potentially released tomorrow
Proprietary
Copyright © 2026 Fabio De Deo. All rights reserved.
Private repository
Source and project history are not publicly accessible.
No public binary
No executable, installer or portable package is currently offered.
Future release
Licensing, packaging, support and protocol compatibility will be reviewed before publication.