notch-limits v1.1.0

What's new

• Accounts found automatically. Claude Code config folders such as ~/.claude-work that contain a .claude.json, and Codex homes such as ~/.codex that contain an auth.json, show up at launch and whenever you open Settings. No JSON to write; folders kept anywhere else still go in accounts.json by hand.
• A Settings window. Open it with the gear in the expanded notch or the menu bar panel. Show, hide, rename, reorder and pick an icon for each account. Changes apply at once, with no restart and no network request, and are saved to ~/.config/notch-limits/accounts.json. A file you wrote by hand is copied to accounts.json.bak before Settings first overwrites it.
• Pace on every bar. A faint tick on each bar in the notch panel marks where usage would be if spread evenly over the window. Under any window you're on track to hit before it resets, a line says when: "At this pace: limit today 4:26 PM". It's a straight-line projection from the latest reading, shown once 15% of the window has passed.
• Best now. With two or more accounts of the same provider, the expanded panel tags the one with the most headroom. Claude and Codex accounts are ranked separately.
• Optional notifications. A heads-up when a limit reaches 90%, and another when a limit you hit resets ("Claude Work is available again"). Off by default; turn them on in Settings. Text-only, with no sound and no extra network requests.

Every version: notch-limits.vercel.app/changelog

Install

curl -fsSL https://raw.githubusercontent.com/matheusm/notch-limits/main/install.sh | bash

Or download NotchLimits.dmg below and drag Notch Limits to Applications. The app is not notarized yet, so on first launch open System Settings → Privacy & Security → Open Anyway.

Universal binary (Apple Silicon + Intel) · macOS 14 Sonoma or later.

notch-limits v1.0.1

What's new

• Polished installer: the DMG now opens a branded window (notch with rings, drag arrow and instructions), with large icons and a shortcut to Applications.
• The app is now named Notch Limits (Notch Limits.app). Both the one-line installer and build.sh remove the old NotchLimits.app automatically.

Install

curl -fsSL https://raw.githubusercontent.com/matheusm/notch-limits/main/install.sh | bash

Or download NotchLimits.dmg below and drag Notch Limits to Applications. The app is not notarized yet, so on first launch open System Settings → Privacy & Security → Open Anyway.

Universal binary (Apple Silicon + Intel) · macOS 14 Sonoma or later.

notch-limits v1.0.0

First public release of notch-limits: Claude Code & Codex usage limits, right at your Mac's notch.

Install

One line (no Gatekeeper prompt):

curl -fsSL https://raw.githubusercontent.com/matheusm/notch-limits/main/install.sh | bash

Or download NotchLimits.dmg below, open it and drag Notch Limits to Applications.
The app is not notarized yet: on first launch open System Settings → Privacy & Security → Open Anyway.

Universal binary (Apple Silicon + Intel) · macOS 14 Sonoma or later.

What's in it

• Progress rings around the MacBook notch, one per account, expanding on hover into every limit window (5h session, weekly, per-model) with reset times
• Multiple Claude Code accounts (CLAUDE_CONFIG_DIR) and Codex, configured in ~/.config/notch-limits/accounts.json
• Local-first: reads the usage snapshots Claude Code and Codex already write to disk; calls the usage API only when data is 10+ minutes old; honors Retry-After
• Per-account data age, color only at 70% / 90%
• Menu bar fallback on Macs without a notch, launch at login
• English, Português and Español, following the system language