Automatic background refresh cadence
Codex-only. Local-first. Fast to scan.
Track live Codex quotas and switch accounts without friction.
CodexControl gives macOS and Windows users a cleaner way to manage multiple Codex accounts. It reads live quota windows directly, shows exact reset times, and lets you move between accounts without losing track of what is actually usable.
- Live readsDirect quota windows from OpenAI
- Exact resets5-hour and 7-day refill times
- Fast switchingChange the active local Codex identity
Usable now
Quota-first account sorting
Reset windows
5h and 7d shown independently
Native macOS app and Windows tray app
Auth state and snapshots stay on-device
Install
Get the app with one command
The recommended macOS path is Homebrew. Direct GitHub release downloads stay available if you prefer manual installation.
Homebrew
brew install --cask ademisler/tap/codexcontrol
Direct Release
Core capabilities
Built for practical Codex account operations
The product is intentionally narrow: accurate quota visibility, clear reset windows, and reliable local account switching.
Live quota windows
Reads quota state directly from OpenAI using each account’s local auth data instead of scraping dashboards or estimating usage.
5-hour and 7-day tracking
Team and paid account windows stay separated, so a depleted short window does not corrupt the weekly view.
Exact reset timing
Every window shows its next refill time. Sorting favors accounts you can use now, then those that recover the soonest.
Active account switching
Switches the local Codex identity and restarts the desktop app on macOS so the new session becomes effective immediately.
Minimal overhead
No browser-resident quota loop, no multi-provider sprawl, and no unnecessary background surface area.
Local-first by default
Tokens, account homes, and snapshots stay on your machine. Public repository assets use demo data only.
How it works
One workflow, optimized for clarity
Load local account homes
CodexControl reads the account homes you manage on the device.
Refresh auth if required
It uses the local auth state and refreshes tokens when a live read needs it.
Query real quota state
Quota windows are normalized conservatively so weekly and short windows remain accurate.
Prioritize usable accounts
The list keeps immediately usable accounts on top and pushes blocked accounts below them.
FAQ
Questions people usually ask first
Does the app depend on CodexBar?
No. CodexControl is a separate app with its own runtime, storage, and quota-fetching logic.
Does it upload my account data anywhere?
No. The app is local-first. It reads local account state and requests quota data directly from OpenAI.
Which platforms are supported?
The repository ships a native macOS menu bar app and a Windows tray implementation.