Claude usage limits in your MacBook notch
If you use Claude Code on a Pro or Max plan, you have a 5-hour limit and a weekly limit. Brim puts both next to the notch, so you can see how close you are without switching to a terminal or a browser to check.
What you see
- Two rings: the 5-hour window and the weekly window, each with its reset time.
- A forecast: at your current pace, when you'll run out, or that you'll last until the reset.
- A glance in the ear: pin the usage percentage beside the closed notch, so it's visible all the time.
- Heads-ups: a notice at 75% and an alert at 90%, once per window.
How it gets the numbers
Claude Code can run a command to draw its status line, and it hands that command a small JSON object on every update. On Pro and Max plans the object includes your rate limits: how much of each window you've used and when it resets.
Click Connect Claude Code in Brim's Claude tab. Brim shows you the statusLine setting in ~/.claude/settings.json before and after, saves a backup next to the file, and only writes it when you click Apply. From then on, Claude Code passes the numbers to Brim's brim command, which forwards them to the app over a local socket and then runs your previous status line, so your terminal looks the same as before.
- No login, no Keychain, no tokens. Brim never reads your Claude account. It only sees what Claude Code already puts in its status line.
- Nothing goes online. The numbers move from Claude Code to Brim on your Mac.
- Easy to undo.
brim statusline uninstall, or Uninstall Brim… in the menu-bar menu, puts your previous status line back exactly.
Good to know
- The numbers update while a Claude Code session is running. Usage from claude.ai or the desktop app shows up at your next Claude Code turn.
- Claude Code includes rate limits only for subscription plans (Pro, Max and similar). With an API key there are no plan limits to show.
- Weekly limits for a single model and extra usage aren't in the status line, so Brim doesn't show them.
Also for Claude Code users
Run brim hooks install claude-code once (it backs up your settings first) and the notch also shows each agent session: waiting for you, working, error or done. When Claude asks to run a tool, the request appears in the notch with the command, and ⌘Y allows, ⌘N denies. Ignore it and the question goes back to your terminal.
Install Brim with one command
curl -fsSL https://brim-ehw.pages.dev/install.sh | sh
Free. macOS 15 or later, Apple Silicon. Read the script first, or see everything Brim changes on your Mac.