Display Codex CLI usage reset time

An unofficial CLI tool that shows when your Codex CLI usage limits will reset. Perfect for statusline integration.

Unofficial project. Not affiliated with, endorsed by, or supported by OpenAI. Compatibility depends on the locally installed Codex CLI and may change as the experimental app-server evolves.

bunx cxreset
cxreset in action

Output Format

Codex: 5h:2h30m(5%) | 7d:3d12h(11%)
Item Description
Codex: Prefix (distinguishes from ccreset)
5h: 5-hour reset window
2h30m Time until reset
(5%) Current usage (%)
7d: 7-day (weekly) reset window
3d12h Time until weekly reset
(11%) Weekly usage (%)

Installation

Recommended

bunx cxreset

Alternatives

npx cxreset
pnpm dlx cxreset

Global Install

npm install -g cxreset

Statusline Configuration

Add to your Claude Code settings file:

~/.claude/settings.json

Bun runtime

{
  "statusLine": {
    "type": "command",
    "command": "bunx cxreset"
  }
}

Node.js-only runtime

{
  "statusLine": {
    "type": "command",
    "command": "npx cxreset"
  }
}

Requirements