Overview
CodexControl is a focused desktop utility for people who actively use multiple Codex accounts. It reads live quota windows from each account’s local authentication state and switches the ambient Codex account used by the local CLI and desktop application.
It does not estimate usage and it is not a general multi-provider dashboard. The product is intentionally limited to the two decisions that matter in this workflow: which account is usable, and which account is currently active.
The problem
When several accounts have independent five-hour and seven-day quota windows, switching blindly is inefficient. A user needs to see the real state of each window, its reset time, and whether the desktop application is actually using the selected account.
Product approach
CodexControl provides:
- live quota reads from OpenAI using local account authentication;
- separate preservation of five-hour and seven-day windows;
- exact reset times;
- active account switching;
- reauthentication without recreating the account list;
- local labels, folders, refresh, and removal controls;
- periodic refresh and usefulness-based sorting.
The accuracy path uses cache-bypassing requests, repeated live reads, equivalence checks, rejection of inconsistent responses, and stale snapshot removal after failures.
Platform implementation
The macOS application is built with SwiftUI and AppKit as a menu bar utility. The Windows implementation uses Python and a tray-first workflow. Switching updates the relevant local Codex state and refreshes Codex Desktop where the platform requires it.
All saved account files remain on the user’s computer. Public screenshots use synthetic accounts, and the repository does not contain real tokens or account snapshots.
My role
I designed the narrow product workflow, implemented the macOS and Windows applications, built the live quota normalization and switching logic, and prepared the website, Homebrew installation, release automation, and security documentation.
Current status
CodexControl is released as an open-source project with a public website, GitHub releases, and a Homebrew cask for macOS.