ccreset

日本語版 README

A CLI tool to display Claude Code usage reset time. Ideal for statusline display. Can also be used as a display component for ccstatusline.

Installation

# Run directly with bunx (recommended)
bunx ccreset

# Run with npx
npx ccreset

# Run with pnpm
pnpm dlx ccreset

# Global install
bun add -g ccreset
# or
npm install -g ccreset

Usage

ccreset

Output

5h:2h30m(16%) | 7d:3d12h(7%)

| Field | Description | |-------|-------------| | 5h: | 5-hour reset window | | 2h30m | Time remaining until reset | | (16%) | Current usage | | 7d: | 7-day (weekly) reset window | | 3d12h | Time remaining until reset | | (7%) | Current usage |

Claude Code Statusline

Add the following to ~/.claude/settings.json:

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

Requirements

• Bun runtime (recommended) or Node.js
• Logged into Claude Code (~/.claude/.credentials.json required)

How it works

Uses Claude Code's OAuth credentials to fetch usage information from the Anthropic API.

License

MIT