Codex Usage Deck

Track every Codex account side by side on your Stream Deck - each styled its own way - plus 8 key types, 6 key faces, and pace keys that show your burn rate against the time left in each window. Not another usage ticker. All metrics are accurate, verified and puts YOU in control of style, layout and how you operate within your dashboard.

🎨 Make it yours - 12 theme presets (now including Paper and Night) x 6 key faces (bar, pill, donut, ring, sparkline, heatmap) - 70+ looks before you touch an override. Per-key title, colors, and background overrides included.

👥 Accounts with separate looks - name each account, point any key at it, and theme it differently. Styles can be tied to each account! One click applies a look to ALL keys.

📈 3 pace projections - average % per day, burn vs even pace, days until empty - plus heatmaps and sparklines that show the trend, not just the level.

📊 8 key types: Session Usage, Weekly Usage, Session + Weekly on one key, a Cycle key, Reset Countdown (pick which window), and the 3 pace keys.

🎛️ Stream Deck + dials - Cycle Metrics, Pace: Heatmap, and Pace: Sparkline also run on Stream Deck + and + XL dials, using the same settings as the key. The reset countdown reads as one big number (like 23h or 42m), or days + hours if you prefer.

🔔 Alerts on your terms - set Watch, Risk, and Critical alert thresholds where you want them, or use pace-based mode that adapts to the time left in the selected window.

🧪 Try before you connect - demo mode paints sample data with no cookie. Long-press any key opens chatgpt.com/codex.

Requirements

- Stream Deck 7.1+; Windows 10 or macOS 12+

- Requires a Codex / ChatGPT account. Sign in with the Codex CLI on this machine, or paste a chatgpt.com session cookie locally. Secrets stay 100% local. Unofficial API.

- Not affiliated with or endorsed by OpenAI.

🙏 My commitment

Built and maintained by a developer who uses it daily. Feedback goes straight into the roadmap - bug reports and feature requests encouraged.

✳️ I hold every plugin I release to a high bar, and honest feedback is part of how it gets raised. If something feels off, I want to hear it.

MORE COMING!

Want one for your provider? It's likely already in development! Message me for info.

Stay tuned for more updates - Lots coming! 😎

Keywords: Codex, Codex CLI, OpenAI Codex, ChatGPT, OpenAI, Stream Deck, Stream Deck Plus, Stream Deck dials, usage monitor, usage tracker, session limit, weekly limit, rate limit, productivity, developer tools

DIAL SUPPORT!! Cycle Metrics, Pace: Heatmap and Pace: Sparkline now work on Stream Deck + and + XL dials. A dial uses the same settings as the key. Press in the dial to activate a "Pro" mode, use the dial to scroll through historical usage data!

The reset countdown now shows one big number in a single unit, like 23h or 42m. If you want the old look, turn on "Show days + hours".

Sparkline days with no usage now draw as 0 instead of a gap. The reset liquid on Cycle Metrics is full right after a reset and drains as the next one gets close. I also made the Paper theme's warning color easier to read.