v1.0.0

This is the initial stable release of Codex Usage, a local CLI for reading Codex reset credits, local usage metadata and read-only online usage/profile data without requiring an OpenAI API key.

Highlights

• Shows Codex reset credits, expiry times and warning windows in the terminal.
• Reports local Codex usage metadata from ~/.codex, including sessions, models, daily totals and high-usage sessions.
• Provides read-only online usage/profile reports for the account state visible to the current Codex login.
• Supports an interactive menu as well as direct commands for all, resets, local-usage, online-usage and export.
• Writes optional TXT, JSON or CSV reports beside codex_usage.py.

Privacy and network behaviour

• local-usage makes no network calls.
• Networked reports reuse the existing Codex login at ~/.codex/auth.json; no OpenAI API key is required.
• Local reports avoid prompt text, assistant text, command text, diffs, transcripts and secret contents.
• Online responses are redacted before display or export.
• Online reports use undocumented read-only backend endpoints, so their shape and availability may change.

Installation and use

• Requires Python 3.10 or newer on macOS or Linux.
• Run directly from source with python3 codex_usage.py or make the file executable with chmod +x codex_usage.py.
• Use python3 codex_usage.py --help and python3 codex_usage.py export --help for the command reference.

Compatibility and release scope

• This is the first stable release, so there is no previous upgrade path.
• The release ships source only: codex_usage.py, README.md and LICENCE.
• No generated reports, account data, local Codex files or runtime artefacts are part of the release.