v1.1.0

This minor release adds optional OpenAI API organisation usage and cost reporting while keeping the existing Codex and ChatGPT reports unchanged.

Highlights

• Adds the api-usage command for OpenAI API organisation usage and costs.
• Adds api-usage to the interactive menu and to export --report api-usage.
• Supports TXT, JSON and CSV output for the optional API usage report.
• Keeps the default all report unchanged, so existing reports do not require an OpenAI Admin key.

Privacy and network behaviour

• api-usage reads OPENAI_ADMIN_KEY from the environment only.
• The Admin key is not accepted as a command-line argument and is never printed or exported.
• The tool does not read ~/.codex/auth.json for OpenAI Admin API access.
• API key, organisation, project and user identifiers are shortened before display or export.
• Missing OPENAI_ADMIN_KEY exits cleanly without making network calls.

Installation and use

• Existing users can keep using the same commands as before.
• Set OPENAI_ADMIN_KEY only when running the optional api-usage report.
• Use python3 codex_usage.py api-usage --help for the new command options.
• Use python3 codex_usage.py export --report api-usage --format txt|json|csv for exports.

Compatibility and release scope

• This release is backwards-compatible with the existing all, resets, local-usage, online-usage and export workflows.
• The release ships source only: codex_usage.py, README.md and LICENCE.
• No generated reports, account data, local Codex files, Admin keys or runtime artefacts are part of the release.

v1.0.1

This patch release makes online usage reports more tolerant of unexpected backend response values.

Changes

• Online daily usage reports now continue rendering when model credit fields contain non-numeric values.
• Unexpected or unavailable credit values no longer stop the report output.

Update

No special update steps are required. Replace the script with the new version and keep using the same commands as before.

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.