Codex Usage is a free local monitor for OpenAI Codex usage, remaining limits, and reset times.
It works with your existing authenticated Codex CLI session and can show usage in the terminal or a local browser dashboard.
Run directly with npm:
npx @codex-usage/codex-usageOr install the CLI:
curl -fsSL https://www.codexusage.dev/install.sh | shThen run:
codex-usageFor the local browser dashboard and full installation instructions:
https://www.codexusage.dev/install
- macOS
- Python 3
- OpenAI Codex CLI installed and available as
codex - An authenticated Codex account
- Current 5-hour usage
- Current weekly usage
- Reset times
- Remaining allowance
- Local browser dashboard
- Session usage and pacing information when available
Codex Usage also provides machine-readable usage output, privacy-safe diagnostics, and version information through its CLI.
Install the Codex Usage Skill from this repository:
npx skills add https://github.com/fiz-is/codex-usage --skill codex-usageThe Skill lets Codex read your locally installed Codex Usage CLI to answer questions about remaining usage, reset timing, current limit pressure, and privacy-safe usage diagnostics.
To generate a diagnostic directly:
codex-usage --diagnosticThis produces a privacy-safe Markdown usage snapshot suitable for troubleshooting or a public bug report.
Codex Usage runs locally and uses your existing authenticated Codex client.
It does not ask you to paste account credentials into the tool and does not add telemetry or analytics.
A native macOS menu bar companion is also available.
Installation details and downloads:
https://www.codexusage.dev/install
This repository contains the public distribution files for Codex Usage.
Codex Usage is an independent project and is not affiliated with or endorsed by OpenAI.
Codex Usage is proprietary software and is not open source.
Personal and internal business use of unmodified copies is permitted. Redistribution, modification, sublicensing, sale, and derivative works require prior written permission.
See LICENSE.