What it does
Monitor Token is a small floating widget that shows how many tokens you have used with the Codex CLI. It reads the session files Codex keeps in the ~/.codex/sessions folder on your own machine and totals usage for today, this week and this month in your local time zone, with input, output, cache and reasoning breakdowns. It also tries to fetch the main weekly quota percentage and reset time from the local Codex service. If that is unavailable it falls back to the latest local session snapshot, or you can enter a weekly token quota by hand. There are three widget styles (gauge card, minimal status bar and light card) and four number formats. Drag the window to move it, double-click to refresh and right-click for settings. The README says token counting happens on your device, that it does not read prompts or replies, does not upload session records and does not rely on a third-party analytics service. You need the Codex CLI installed and signed in. Releases cover Windows x64 and macOS on Apple Silicon and Intel; Linux is on the roadmap. The installers are not code-signed yet, so Windows may show a SmartScreen warning. It is a Python app that uses PySide6, released under the MIT license, and can also be run from source with Python 3.9 or later.
Capabilities
- Token totals for today, this week and this month
- Input, output, cache and reasoning breakdown
- Weekly quota percentage and reset time
- Three widget styles and four number formats
- Counts locally and does not upload session records
- Windows and macOS builds under the MIT license
When to use it
- You use the Codex CLI and want to see your token use without opening anything
- You want to know how much of the weekly quota is used and when it resets
- You prefer a monitor that keeps its counting on your own machine
