Session 5h 82%limits[kind=session]

1:07:12

Reset

claude

❯ /usage

Current session
  18% used
Resets 12:20am (Europe/Paris)

Current week (all models)
  20% used
Resets Sep 18 at 1am (Europe/Paris)

Current week (Fable)
  18% used
Resets Sep 18 at 12:59am (Europe/Paris)

❯ …and again in ten minutes.

The widget floats above every window, at this exact size. Click it: it folds down to the session bar, like the real one. When the bar runs out, the window resets and a new round starts. demo · numbers are simulated

Your Claude usage as a Tekken health bar, on your desktop.

Install

$ git clone https://github.com/Scra3/claude-hp
$ cd claude-hp && ./build.sh
$ open ClaudeHP.app

macOS 15. First launch asks for keychain access to your Claude Code token. Click Always Allow. The token only signs the usage call; it is never logged or written to disk.

Three bars

5 hour session, weekly, and the weekly Fable window. Click to fold or expand. If Anthropic adds a limit for another model, it shows up as its own bar. Nothing to recode.

Same numbers

GET /api/oauth/usage, the limits[] array. Exactly what /usage prints. Under 20% the bar goes red and pulses. If the call fails it says so instead of showing a stale number.

One file

One Swift file, no Xcode project, built with swiftc. Fork it, change the colors, make it yours.