Skip to content

notch-limits v1.0.0

Choose a tag to compare

@matheusm matheusm released this 03 Nov 02:25
· 28 commits to main since this release

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