Display OpenAI Codex usage reset time

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

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