uNotch

uNotch is a lightweight menu bar utility for Claude, Codex, Cursor Agent, and Antigravity. Its nearly hidden edge cue expands into a glass usage HUD when you hover — no dashboard window and no Dock icon.

What it monitors

Provider	Local source	Usage shown
Claude	Claude Code CLI /usage, plus Claude's usage endpoint for resets	5-hour, weekly, and Fable limits, plus granted limit resets when any (Use reset applies one)
Codex	Codex app-server rate limits	Plan windows, plus banked resets when any remain (Use reset spends one)
Cursor	Cursor dashboard usage RPCs (Agent /usage fallback)	Cursor Models and Other Models
Grok Bot	Cursor dashboard usage RPCs, through the Cursor sign-in	Grok Bot's own allowance
Antigravity	Antigravity's quota endpoint, with the agy CLI's sign-in	5-hour and weekly usage

All usage is read from command-line tools already authenticated on your Mac, or with the session those tools already keep in your login keychain (Cursor's dashboard RPCs; Claude's usage endpoint, for resets; Antigravity's quota endpoint). uNotch does not ask for, copy, or store provider credentials. Only the providers whose CLI is installed appear; the rail sizes to fit one to five. Antigravity's sign-in token lasts an hour and only agy can renew it, so when it has lapsed uNotch runs agy models — which signs in and runs no model — at most once an hour. Grok Bot has no CLI of its own — its ring sits under Cursor's and appears once a read shows your Cursor plan includes it.

More than one subscription

If you keep a second Claude Code, Codex, or Cursor sign-in in its own folder, uNotch finds it automatically:

alias cc-dev='CLAUDE_CONFIG_DIR=~/.claude-dev claude'
alias cx-work='CODEX_HOME=~/.codex-work codex'
alias agent-work='CURSOR_CONFIG_DIR=~/.cursor-work agent'

The folder and the alias can be called anything. uNotch looks one level into your home folder and ~/.config for a directory the CLI has used as its home — Claude Code leaves a .claude.json there; Codex leaves an auth.json beside its config.toml; Cursor Agent leaves a cli-config.json (the default ~/.cursor is not a second sign-in) — and reads that sign-in. There is nothing else to configure. The label comes from the folder name (~/.claude-dev → dev, ~/.cursor-work → work). For Antigravity, uNotch reads the sign-in agy keeps in the login keychain; a second agy sign-in is not looked for.

Each provider still has one ring. Once a second subscription is signed in, a strip appears under the pop-out's title with one cell per subscription — its name over its remaining percent. Hover a cell to look at it; the limits and the ring follow. Click a cell to make it the favourite (marked ★): that is the one the provider opens on and its ring reports whenever the HUD is closed. Click it again to clear. The cells share the row equally, so five subscriptions read as cleanly as two; a long name trails off, and hovering it shows the full name. A subscription that is signed out is not shown; sign in with your alias and it appears within a minute.

Install

1. Download uNotch-arm64.dmg — the latest signed release. Release notes are on the releases page.
2. Open it and drag uNotch into Applications.
3. Launch uNotch from Applications. Its mark appears in the menu bar.

The release app and DMG are Developer ID signed, Apple notarized, and stapled. The installer supports Apple silicon Macs running macOS 14 Sonoma or newer.

Use

• Move the pointer to the subtle cue at the screen edge and hold for 150 ms to reveal the HUD.
• Hover a provider logo to switch providers and refresh stale usage. A ring at or below 10% remaining is red, hovered or not — a full red circle even at 0%. Above 10% the ring you are on is mint. The first time something drops to 10% or below, the whole edge cue turns red. Opening it dismisses that, and the cue stays quiet until that usage climbs above 10% and drops again. Claude's ring follows the lower of the 5-hour window and the weekly limit, and so does Antigravity's, which always sits at the bottom of the rail. Providers without an installed CLI are not shown; install one and its ring appears within a minute.
• Use the refresh control for an immediate read from the selected local CLI.
• On Codex, when Resets available shows a count above zero, Use reset spends one banked credit through the local Codex CLI and refreshes usage.
• On Claude, when your account has been granted a limit reset (what claude.ai lists under Settings → Usage → Resets), Resets available shows the count and its expiry, and Use reset applies one — the same request Claude Code makes for "Use an available limit reset" — then refreshes usage. Resets are checked every ten minutes, so a new grant can take that long to appear.
• Drag the rail vertically or across the display to place it on either edge.
• Hover the settings gear at the bottom of the rail. The section hangs from the gear so you can move into it, and it holds everything uNotch can be told:
  • Side — dock to the left or right edge.
  • Position — a drag handle to move the HUD anywhere along the edge.
  • Update & Restart — fetch the latest signed release and relaunch.
  • Quit.
• The menu bar item offers the same refresh, edge, update, and quit actions.

The saved edge and vertical position are restored on the next launch.

Privacy by design

• No analytics, telemetry, advertising, or crash-reporting SDKs.
• No uNotch account, cloud service, incoming server, or listening port.
• CLI output is parsed in memory and is not logged or written to disk.
• Raw CLI errors are discarded so account identifiers and local paths are not exposed in the interface.
• Only the screen edge and vertical position are stored in macOS preferences.
• Network use is Update & Restart (GitHub Releases, only when you click it), Cursor dashboard usage RPCs that reuse the local Agent session, Claude's usage endpoint for resets, and Antigravity's quota summary with agy's sign-in. Those usage endpoints do not run models or spend included usage.

Provider CLIs still use their own network connections, authentication stores, and caches. See PRIVACY.md for the complete data flow and SECURITY.md for trust boundaries, the update verification steps, and how to report a vulnerability.

Requirements

• macOS 14 or newer
• Apple silicon for the downloadable DMG
• At least one supported local CLI: claude, codex, Cursor's agent, or Antigravity's agy

Missing or signed-out CLIs are shown as unavailable without affecting the other providers.

Build from source

The Swift package has no third-party package dependencies.

swift test
swift run uNotch

Create a local release DMG:

./scripts/build-dmg.sh

For a notarized distribution build, provide a Developer ID identity and a notarytool profile stored in Keychain. Never put their real values in the repository.

APPLE_SIGNING_IDENTITY="Developer ID Application: …" \
NOTARY_PROFILE="your-keychain-profile" \
./scripts/build-dmg.sh

The script signs the app with hardened runtime, optionally notarizes and staples it, creates the DMG, then signs and optionally notarizes and staples the installer.

Verify a download

Download SHA256SUMS from the same release, then run:

shasum -a 256 -c SHA256SUMS
xcrun stapler validate uNotch-arm64.dmg
spctl --assess --type open --context context:primary-signature --verbose=2 \
  uNotch-arm64.dmg

spctl should report accepted with a notarized Developer ID source.

Project layout

Sources/uNotch/        AppKit windowing, SwiftUI UI, state, CLI readers, updater
Tests/uNotchTests/     Parser, state, hover geometry, updater, and render checks
brand/                 Brand canon: BRAND.md, tokens, logo variants
site/                  The single-page website (Caddy on Railway)
Resources/             macOS bundle metadata
scripts/               Icon generation and signed DMG packaging
DESIGN.md              Generated design system (Stitch format) for AI agents

Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md first — it covers the scope uNotch keeps deliberately small, how to run the tests, and the review flow. main is protected: changes land through reviewed pull requests with CI passing.

Security

Please do not disclose a suspected vulnerability in a public issue. Use GitHub's private vulnerability report so it can be investigated before publication.

License

MIT © 2026 Seth Medina. Claude, Codex, ChatGPT, Cursor, Antigravity, and Gemini are trademarks of their respective owners; uNotch is an independent project and is not affiliated with Anthropic, OpenAI, Anysphere, or Google.