Display Claude Code usage reset time

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

bunx ccreset
ccreset in action

Output Format

5h:2h30m(6%) | 7d:3d12h(35%)
Item Description
5h: 5-hour reset window
2h30m Time until reset
(6%) Current usage (%)
7d: 7-day (weekly) reset window
3d12h Time until weekly reset
(35%) Weekly usage (%)

Installation

Recommended

bunx ccreset

Alternatives

npx ccreset
pnpm dlx ccreset

Global Install

npm install -g ccreset

Statusline Configuration

Add to your Claude Code settings file:

~/.claude/settings.json

Bun runtime

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

Node.js-only runtime

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

Requirements