Skip to content

v0.12.0 — Historical Usage dashboard

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Sep 16:57
· 101 commits to main since this release
v0.12.0
0604e05

Highlights

A new Usage tab

See your account's historical token activity alongside Quota, Monitor, and Benchmark—without interrupting your Codex session or starting model turns.

  • Daily activity calendar: GitHub-style blocks get brighter as usage increases, with theme colours, weekday/month labels, and a Less/More legend.
  • Weekly and Cumulative charts: responsive fractional-block bars show weekly totals or accumulated usage over the selected range.
  • 6-month / 12-month selection: clickable controls or 6 / 1 switch between 26 and 52 weeks instantly. Cumulative totals restart at the selected range's beginning; 12 months is the default.
  • Full-year-first layouts: cells, bars, and spacing shrink to fit the selected range. All views fit a full year at standard 80-column width; narrower terminals can page with arrows or Page Up/Page Down.
  • Account summary: lifetime tokens, peak daily usage, and current streak when Codex supplies them.

Usage uses the prevailing Codex login and refreshes on entry, periodically while selected, or with r. Missing history is distinguished from zero activity; failed refreshes label retained data stale, and account changes discard old history. The demo includes sample history.

Reliability

  • Preserve underlying account-verification error details when fetching Usage.
  • Regression coverage for aggregation, overflow, account changes, responsive layouts, range switching, and clickable controls.
  • Removed a wall-clock-sensitive layout assertion.

Historical data comes from Codex's account/usage/read endpoint and may lag live Monitor telemetry. It contains daily token totals—not historical model/cache breakdowns, API-equivalent cost, or reset-event history. Requires a supported Codex CLI and account.

Upgrade

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/merefield/codexometer/main/install-release.sh | sh

For Windows, use the PowerShell release installer instructions. Alternatively, download the matching archive below. Restart Codexometer after upgrading; codexometer --version should report 0.12.0.

Full changelog: v0.11.4 → v0.12.0 · Usage PR #39

Assets 9
Loading