Skip to content

v1.1.0

Latest

Choose a tag to compare

@MacSteini MacSteini released this 29 Jun 22:51

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.