Hachibu — AI skill for Claude Code

Hachibu

I spend a worrying amount of my life checking my Claude Code usage, so I made it stay on screen. Hachibu is a small strip on top of your Mac's screen that shows Claude Code's model, effort, and usage limits. One glance is enough, and you can get back to your work.

The name comes from hara hachi bu (腹八分), the Japanese habit of eating until you are 80% full.


Hachibu is an unofficial tool made by an individual. It is not affiliated with, endorsed by, or sponsored by Anthropic, PBC.

[Download Hachibu for macOS](https://github.com/BoxPistols/hachibu/releases/latest/download/Hachibu-macos.zip) (macOS 14 or later, Apple Silicon or Intel). macOS blocks the first launch because the app is not notarized yet. You need to allow it once in System Settings > Privacy & Security; [First launch](#first-launch-allow-it-once-in-system-settings) shows each step.

[日本語の説明はこちら](#日本語)

What it shows

`Opus5 1M xhigh · S42 W76 F55` reads as: model, effort, then usage. S is the 5-hour limit, W the weekly limit, and F a per-model weekly limit (the first letter of the model's name).

• A usage number turns yellow at 70% and red at 90% by default. You can change both thresholds
• Hover over the strip or open the menu bar item to see when each limit resets
• The strip never takes focus. It stays above other windows, including full-screen apps
• It keeps running whether or not a terminal is open. Turn on Launch at Login from the menu bar item or the strip's right-click menu to bring it back after a restart

Where the numbers come from

Hachibu works on its own. No other tools are needed.

• Model and effort: the conversation Claude Code saved most recently on this Mac, and ~/.claude/settings.json. If you set up the statusLine below, its values are used when they are newer
• Usage: you choose one of two sources

1. Usage API (optional). The first time Hachibu opens, it asks wheth