slobbe/codex-meter
1
0
Fork
You've already forked codex-meter
0
A GNOME shell extension to monitor and manage Codex usage limits
  • TypeScript 82.1%
  • JavaScript 15.1%
  • CSS 2.1%
  • Makefile 0.7%
2026年07月12日 21:57:40 +02:00
.github/workflows Pin tree-sitter for shexli 2026年07月02日 11:54:26 +02:00
assets Reduce about page logo size 2026年06月28日 17:25:21 +02:00
docs/assets Update preview 2026年07月04日 01:16:29 +02:00
icons feat: add openai top bar icon option 2026年05月11日 14:54:03 +02:00
schemas Change default refresh interval from 1 to 5 minutes 2026年07月03日 16:25:06 +02:00
src fix: tolerate missing Codex session limit 2026年07月12日 21:57:40 +02:00
test fix: tolerate missing Codex session limit 2026年07月12日 21:57:40 +02:00
.gitignore Fetch banked resets less often 2026年07月03日 16:25:06 +02:00
CONTRIBUTING.md Add contributing guide 2026年06月28日 18:35:57 +02:00
LICENSE Add GNU GPL v3 License 2026年04月08日 13:59:01 +02:00
Makefile feat: add logo to preferences about page 2026年05月15日 21:03:56 +02:00
metadata.json chore: bump version to 0.8.8 2026年07月12日 21:57:40 +02:00
package-lock.json chore: bump version to 0.8.8 2026年07月12日 21:57:40 +02:00
package.json chore: bump version to 0.8.8 2026年07月12日 21:57:40 +02:00
README.md Document local usage storage 2026年07月02日 11:29:27 +02:00
tsconfig.json refactor: finish initial typescript refactor 2026年05月08日 20:23:23 +02:00

Custom badge

badge group

Codex Meter popup preview

Features

  • Displays current 5-hour session and weekly Codex usage.
  • Shows a weekly usage trend and predicts whether limits will be hit before reset.
  • Shows and redeems available banked resets.

Requirements

  • Codex CLI logged in on the same machine
  • GNOME Shell 45+

Install

  1. Download the latest release zip.
  2. Install and enable the extension with:
gnome-extensions install --force codex-meter@slobbe.github.io-<version>.zip
gnome-extensions enable codex-meter@slobbe.github.io

If GNOME does not pick it up immediately, log out and back in.

Privacy

Codex Meter reads your local Codex auth credentials from ~/.codex/auth.json and uses them to fetch usage and banked reset data from ChatGPT. It does not store those credentials or transmit them anywhere else.

The extension stores non-credential usage data locally so the panel can show cached state, trends, and banked reset information while refreshing. It writes the latest usage and banked-reset snapshots in the user cache directory, typically ~/.cache/codex-meter, and usage history in the user state directory, typically ~/.local/state/codex-meter. Usage history is pruned to roughly the last 21 days and at most 25,000 entries. These files are written with private file permissions where supported by the platform.

License

GPL-3.0-or-later