Claude Notch
AI usage limits in your Mac's notch, for Claude, Codex, Antigravity, DeepSeek and opencode-go.
Limits, resets, tokens and cost, one click away.
Collapsed, it's just Clawd (the crab) and your session % beside the camera. Click it and the
island glides open into a two-page card you can swipe through: your real limits up front, your
spend and sessions behind. Click away and it glides shut. No Dock icon, no menu-bar clutter.
Install
- Download
Claude Notch.zip from the latest release, unzip it and drag Claude Notch.app to Applications.
- Open it. It's signed and notarized, so there's no security warning. When the Keychain prompt appears, choose Always Allow so it can read your local Claude session.
- Keep it around. Right-click the island and choose Launch at Login.
You need macOS 14 or later (Apple Silicon or Intel) and at least one of: a signed-in Claude session,
an authenticated Codex installation, an Antigravity CLI (agy) login, a DeepSeek API key, or an
opencode-go account.
git clone https://github.com/stevemcqueenz/claude-notch-tracker
cd claude-notch-tracker
swift run ClaudeNotch # dev run
bash scripts/make-app.sh # builds dist/Claude Notch.app + a shareable zip
Requires a full Xcode toolchain (the SwiftUI macros need it). Run
export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer if swift points at the
Command Line Tools.
Every page of the island
Providers
Only providers installed on your Mac appear. Click the left icon to cycle through them, or let the
island rotate on its own every 10 s, 30 s or minute (it holds still while the card is open).
| Provider | What you see | Where it comes from |
|---|
| Claude | 5-hour, 7-day and Fable weekly limits, credits, today's cost with a projection for tonight, named sessions, all-time projects | Claude Desktop, a browser signed in to claude.ai, or the Claude Code CLI login. Cost and tokens from your local ~/.claude logs |
| Codex | Rate-limit windows, token totals, credits, plan, recent tasks, 7-day token chart | The official local codex app-server interface |
| Antigravity | Quota windows, tokens, models, projects, week chart | The agy CLI's read-only /usage command (spends no quota), plus its local conversation stores |
| DeepSeek | Balance, peak or off-peak pricing right now, spend today and this week | Your DeepSeek API key. Spend is observed from the balance going down, and labelled so |
| opencode-go | 5-hour, weekly and monthly meters, renewals, Zen balance, sessions | Your opencode.ai browser session, with local history as the fallback |
Features
- Real limit tiles. Your 5-hour session, 7-day weekly and Fable's own weekly limit, the same
three bars the Claude desktop app shows, each with a reset countdown and colour-coded urgency.
- Two pages, one swipe. Limits up front. Swipe (or tap the dots) to a local detail page with
today versus all-time spend, plus your live sessions.
- Named sessions. Your actual conversation titles from the sidebar, with today's spend per
conversation. Tap the block to flip to your all-time biggest projects.
- Cost, live. Cost today with an "~$X by tonight" projection, your usage-credit balance, and
all-time totals from a full-history scan of your logs.
- A week at a glance. Claude, Codex and Antigravity chart the last 7 days right in the island, with today
highlighted and the peak day labelled.
- DeepSeek, priced by the hour. A dot shows the billing phase: green off-peak, amber at peak
(09:00–12:00 and 14:00–18:00 Beijing time on working days, when DeepSeek bills double). Chinese
public holidays count as off-peak, as DeepSeek's pricing says.
- Clawd, the walking crab. He quickens as you approach a limit and freezes when you're out.
Prefer a mono crab or the Claude Spark? Pick your look from the right-click Icon menu.
- Hide in full screen. An opt-in toggle tucks the island into the notch while a full-screen
app owns the display, then slides it back on exit.
- Zero fuss. It draws its own notch on non-notch Macs, updates itself, and lives entirely on a
right-click menu.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
