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

1. Download Claude Notch.zip from the latest release, unzip it and drag Claude Notch.app to Applications.
2. 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.
3. 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.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗