Guide

How to see your Codex usage limit

Codex records its own rate-limit percentages. Here is how to read them without guessing.

The official source

Codex writes a `rate_limits` block (with `used_percent` and `resets_at`) into its rollout logs under `~/.codex/sessions`. That is the authoritative number — the same one OpenAI enforces.

Reading it live

JP the Cat reads that block automatically with zero setup and shows Codex's 5-hour and weekly used-percent, tagged `official`, next to a clearly-labelled notional cost. Because Codex is a subscription, any dollar figure is list-price, not metered spend.

Common questions

Does JP the Cat need my OpenAI login to read Codex usage?: No. It reads the local rollout logs Codex already writes — no credentials, no network.
Why is the Codex dollar figure called notional?: Codex is billed as a flat subscription, so a per-token dollar figure is what the usage would cost at API list prices, not what you actually paid.

See your real numbers with JP the Cat

A light, local menu-bar meter for Claude Code and Codex — real cost, honest limits.

Download Meow