Codex Opero

English | 한국어

codex-opero

codex-opero is a minimal macOS menu bar app that shows AI usage as a compact string like 57%/90%.
Instead of a full dashboard, it focuses on one thing: letting you check the numbers you need at a glance.

Highlights

- Shows the selected provider's remaining usage in a compact two-value format from the menu bar
- Lets you choose between Codex, Claude, and Antigravity
- Lets you switch the compact menu bar and provider-row numbers between remaining quota and used quota
- Remembers the last selected provider
- Supports Auto Rotate to cycle through available providers at a configurable interval
- Lets you choose the refresh interval from preset options in the menu
- Lets you choose the auto-rotate interval from preset options in the menu
- Shows the installed app version at the bottom of the menu and links to a new GitHub Release when available
- Refreshes automatically at the configured interval and also supports Refresh Now
- Shows each provider as soon as its usage lookup finishes, without waiting for slower providers
- Sends reset notifications when important usage buckets return to 100%
- Checks for new GitHub releases every 24 hours after the last successful check
- Supports Launch at Login when running as a packaged .app
- Falls back to --/-- when usage lookup fails

Authentication

This app does not provide its own login UI or OAuth flow.
Instead, it reuses existing local authentication state and only fetches usage.

- Codex: uses ~/.codex/auth.json
- Claude: uses the macOS Keychain item Claude Code-credentials or ~/.claude/.credentials.json and automatically refreshes expiring OAuth access tokens.
- Antigravity (agy): reads the signed-in CLI Keychain credentials or the IDE state database and queries Google directly, even while the…