isccpeak

A CLI statusline showing Claude Code peak-hour status with a live countdown.

🟢 Normal · 4h 30m left    ← off-peak, session limits at normal rate
🔴 Peak · 2h 15m left      ← peak hours, session limits drain faster

Table of Contents

• Quick Start
• Manual Setup
• Output Format
• Piping with Other Statuslines
• Peak Hours
• Development
• License

Quick Start

Add to your ~/.claude/settings.json:

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

Changes take effect immediately — no restart needed.

Manual Setup

Using Bun (recommended)

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

Using npm

{
  "statusLine": {
    "type": "command",
    "command": "npx -y isccpeak"
  }
}

Piping with Other Statuslines

If you already have a statusline command, pipe it into isccpeak to append the peak indicator:

{
  "statusLine": {
    "type": "command",
    "command": "your-existing-command | bunx isccpeak"
  }
}

This produces output like:

your status text | 🟢 Normal · 4h 30m left

Note: JSON stdin (e.g. from commands that output {...}) is automatically ignored — only plain text is prepended.

Output Format

| State | Example | Meaning | | -------- | ------------------------------ | ---------------------------------------------- | | Off-peak | 🟢 Normal · 4h 30m left | Session limits at normal rate, time until peak | | Peak | 🔴 Peak · 2h 15m left | Session limits drain faster, time until off-peak |

Countdown formats: <1m, 42m, 1h 30m.

Peak Hours

Peak hours are Monday–Friday, 5:00 AM – 10:59 AM PT (1:00 PM – 7:00 PM GMT) (Source).

During peak hours, your 5-hour session limits are consumed faster. Outside these hours (evenings, nights, weekends), limits reset at the normal rate.

Development

Requires Bun as the dev toolchain. The shipped artifact targets Node.js ≥ 18.

bun install         # install dependencies
bun run check       # full CI: typecheck → knip → lint → tests + coverage
bun run build       # bundle to dist/cli.js (Node.js target)

License

MIT