This project is intentionally narrow: it displays Codex usage status and nothing else.
- It does not read, print, store, upload, transform, or proxy tokens, cookies, sessions, OAuth credentials, refresh tokens, or API keys.
- It does not read
~/.codex/auth.json. - It does not scrape browser state, browser cookies, web pages, screenshots, or OCR output.
- It does not simulate login or retry login flows.
- It does not modify the official Codex app bundle.
- It does not attempt to bypass, increase, reset, purchase, or route around usage limits.
The only supported live data source is the official local Codex app-server method:
{"method":"account/rateLimits/read","id":1}Codex itself owns authentication and calls its own backend. This project receives only the structured rate-limit response returned by app-server.
The default menu-bar refresh interval is 120 seconds, with a 60-second minimum. Failed refreshes back off to 300 seconds. Keep refreshes conservative; usage status does not need sub-second polling.
Stop at the official boundary. Do not add cookie scraping, token extraction, browser automation, OCR, or patched-app workarounds as fallbacks.