Repository navigation
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 | bashOr 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