Repository navigation
Releases
Codex Usage 0.2.0
Codex Usage 0.2.0 is published in the OpenAI Plugins Directory. The local plugin uses identifier codex-usage; the directory compatibility ZIP retains the existing listing identifier ai-codex-usage. Both packages include the same local usage reader.
AI Codex Usage 0.1.2
Fix local usage queries after installing the plugin on another computer.
- Resolve and execute the reader bundled with the installed skill instead of suggesting a nonexistent fixed script path.
- Report the checked data directory, reader version, detected CLI, and distinct missing-history or access errors.
- Detect the Codex CLI bundled inside ChatGPT.app or Codex.app on macOS, even when the command is absent from PATH.
- When local records cannot answer the question, make one bounded read through existing CLI authentication. Keep historical and live account data separate.
Validation: 19 tests pass, including a fresh extracted installation with spaces and Unicode paths. Plugin and skill validators pass. The reader was also executed on a second MacBook with Python 3.9.6, where both local-history and live CLI reads succeeded without adding Codex to PATH or changing authentication.
Update the plugin and start a new local Codex task. Installation does not transfer history or change which account the existing Codex CLI uses.
AI Codex Usage 0.1.1
Fixes gaps in installed script discovery and unavailable-result diagnostics reported from another computer.
- Resolve and execute the reader shipped with the installed skill; never invent
~/.codex/usage/codex_usage.py. - Report the checked Codex home, reader version, aggregate file/event counts, and distinct reasons for missing or unreadable history.
- Guide one existing-auth CLI read when local snapshots cannot answer the request, keeping live and historical data separate.
- Apply the selected Codex home to live CLI reads as well as history reads.
Validation: 17 tests pass, including extracting the release archive into a fresh installation path with spaces and Unicode characters and querying a separate Codex home. Plugin and skill schema validation pass; the installed reader also runs successfully on the development Mac.
Update the plugin and start a new local Codex task. The exact failure on the reported second computer still requires its execution diagnostics to confirm; this release does not guarantee a quota record exists on every installation.
AI Codex Usage 0.1.0
Initial release of AI Codex Usage.
- Read local Codex usage snapshots without a browser login.
- Report weekly and five-hour limits, reset times, and snapshot freshness.
- Distinguish reset cards from paid credits and preserve unknown values.
- Optionally query existing Codex CLI authentication without signing in or redeeming cards.
Validation: 12 automated tests, plugin validation, skill validation, and a local smoke test passed. Requires Python 3.9+; no Python dependencies.