Home / Guides / Best Codex Trackers
Best Codex Usage Trackers for macOS (2026)
Codex doesn't make it easy to see where you stand — especially after OpenAI's April 2026 switch to token-based rate limits. Here are the four real ways to track your Codex token usage, 5-hour window, weekly cap, and dollar cost, ranked.
Last updated May 2026 · Reflects the April 2026 Codex token-rate-card change · By Soren Starck
Why You Need a Usage Tracker for Codex
If you use Codex daily, you know the pattern: you're deep in a reasoning-heavy session, the agent is iterating, and then it stops. You've hit your 5-hour token budget — and you had no warning it was coming.
OpenAI enforces two stacked rate limits on Codex: a rolling 5-hour token window and a weekly cap. Since April 9, 2026 the longer the agent reasons, the more of your 5-hour budget it consumes — so counting messages no longer predicts when you'll be cut off. Per developers.openai.com/codex/pricing: “Credits remain the core pricing unit that customers purchase and consume, but usage is based on tokens consumed.”
The built-in /status command is a snapshot, not a watch. The OpenAI dashboard lags and lives in a separate browser tab. Neither tells you “you have 18% of your 5-hour budget left, resets in 41 minutes.”
A usage tracker fixes this by giving you visibility before the lockout. We tested four approaches. Here's how they compare.
#1: SessionWatcher for Codex Editor's Pick
SessionWatcher for Codex is a native macOS menu bar app built specifically for tracking Codex CLI and ChatGPT Codex usage. It updates in real time as the agent burns tokens.
What it tracks:
- Live token consumption: Exact tokens burned in the current rolling 5-hour window — including reasoning tokens that
/statusalone doesn't make obvious. - 5-hour window countdown: A live timer showing when your oldest usage rolls off and capacity returns.
- Weekly cap tracker: The second cap most tools ignore. Critical on Plus and the $100 Pro tier.
- Dollar cost: Credits-to-USD translated for you. No spreadsheet, no rate-card lookup.
- Rate-limit percentage: A single number in your menu bar: “67% used.”
- macOS notifications: Get alerted at configurable thresholds (e.g. 70%, 90%) so you can pivot before getting locked out.
- Plan-aware: Knows Plus, Pro 5×, Pro 20×, and the promo multipliers running through May 31, 2026.
Setup: Download, drag to Applications, paste your license key. Tracking in under 30 seconds. No API keys, no scripts.
Pricing: $2.99 one-time for Codex tracking. $7.99 for the 5-tool bundle (Claude Code, Codex, Copilot, Cursor, Gemini).
Limitations: macOS only (requires macOS 15+).
#2: OpenAI Usage Dashboard
The official source for historical Codex usage is the OpenAI dashboard at platform.openai.com/usage. Filter by date range and model to see Codex-specific token consumption and dollar spend.
What it shows:
- Historical tokens by day, week, and month
- Spend in USD, broken down by model (gpt-5-codex, gpt-5, etc.)
- Request count and approximate latency
Pricing: Free.
Limitations: Data lags by several minutes. Does not show your current position in the rolling 5-hour window. No weekly-cap visualization. Requires a browser tab and a login. No notifications. No real-time lockout warnings.
#3: Codex CLI /status Command
Inside an active Codex CLI session, type /status and you'll get remaining tokens for both the rolling 5-hour and weekly windows, your current model, and your plan tier.
What it shows:
- Remaining tokens in the rolling 5-hour window
- Remaining tokens in the weekly window
- Current model and plan
Pricing: Free (built into Codex CLI).
Limitations: Only works while Codex is open — it's a snapshot, not a watch. You have to remember to run it. The number on first invocation of a session can be slightly stale (an open issue in the openai/codex repo). No dollar cost. No notifications.
SessionWatcherStop finding out at 2am.
Just glance up.
Native macOS menu bar app. Track Claude and Codex usage, costs, and rate limits in real-time.
“Fast, simple, and does exactly what it should. Definitely worth it.”
@nicojerome on GitHub
macOS 14+. $2.99 one-time purchase.
#4: DIY Scripts (OpenAI Usage API + cron)
Some developers build their own monitoring by polling the OpenAI Usage API on a schedule, parsing Codex session files, or wrapping the CLI to log tokens locally.
Typical approaches:
- Python scripts that hit the OpenAI Usage API on a cron schedule
- Shell wrappers around Codex CLI that
teeoutput to a log and grep for token counts - tmux or SwiftBar plugins that re-run
/statuson an interval - Custom dashboards built on top of the OpenAI billing API
Pricing: Free, plus your time.
Limitations: The Usage API lags by minutes, which defeats the purpose for real-time lockout avoidance. Codex session format changes every few releases — your parser will break. Weekly-cap math has to be reimplemented. Most developers ship the v1 in a weekend, then forget about it after two breakages.
A note on ccusage and Claude-Code-Usage-Monitor
If you searched for “Codex usage tracker” and ran into these tools, they're Claude-only. ccusage, Claude-Code-Usage-Monitor, and Claude Usage Tracker all read Anthropic's local ~/.claude/projects/*.jsonl files. Codex stores sessions differently and uses a different API. For Codex you need a Codex-specific tool.
Comparison: All 4 Options at a Glance
| Feature | SessionWatcher | Dashboard | /status | DIY |
|---|---|---|---|---|
| Real-time tokens | Yes | Delayed | On demand | Varies |
| 5-hour window countdown | Yes | No | Snapshot | Hard to build |
| Weekly cap tracker | Yes | Partial | Snapshot | Manual |
| macOS notifications | Yes | No | No | DIY |
| Dollar cost | Yes | Yes | No | Varies |
| No workflow interrupt | Menu bar | Browser tab | Run command | Varies |
| Setup time | 30 seconds | None | None | Hours+ |
| Price | $2.99 once | Free | Free | Free + time |
The Verdict
For developers on macOS who use Codex daily, SessionWatcher for Codex is the only option that gives you the full picture: real-time tokens, both stacked windows (5-hour + weekly), dollar cost, and notifications — without making you stop coding.
The free options work if Codex is occasional for you. But if it's part of your daily workflow and a single lockout costs an hour of momentum, $2.99 pays for itself the first time.
SessionWatcherThe Codex usage tracker that's actually always on.
$2.99. No subscription.
Native macOS menu bar app. Track Claude and Codex usage, costs, and rate limits in real-time.
“Fast, simple, and does exactly what it should. Definitely worth it.”
@nicojerome on GitHub
macOS 14+. $2.99 one-time purchase.
Frequently Asked Questions
What is the best Codex usage tracker for Mac?
SessionWatcher for Codex is the best dedicated tracker. Live in your menu bar, tracks both the 5-hour and weekly windows, monitors dollar cost, sends notifications before lockout. $2.99 one-time.
Can I track Codex usage for free?
Yes — /status inside Codex CLI is free, and platform.openai.com/usage is free for historical data. Neither is real-time or always-visible.
Does Codex count messages or tokens?
Tokens, since April 2, 2026. And since April 9, 2026, reasoning depth multiplies the burn — a single deep-reasoning request can consume several percent of a 5-hour window.
Do free Claude trackers like ccusage work with Codex?
No. ccusage and similar tools read Anthropic Claude Code session files only. They don't parse Codex sessions. See our how to check Codex usage guide for the full set of options.
How much does SessionWatcher for Codex cost?
$2.99 one-time for Codex. $7.99 for the bundle that includes Claude Code, Codex, Copilot, Cursor, and Gemini.