Your AI coding quotas, pinned to the screen edge

What it does

Codenotch is a macOS app that parks a small black pill on any screen edge and unfolds on hover to show usage rings for Claude Code, Cursor, Codex, Antigravity, and several other coding assistants. It polls each tool’s own local credentials—keychain items, SQLite sessions, CLI auth files—to read how much of your quota remains and when the window resets, without ever signing in itself. The notch also watches for active sessions, spinning an arc while an agent is busy and pulsing amber when it stops to ask you something.

The interesting bit

The whole thing is essentially polite glue code: every provider adapter reverse-engineers whatever the owning app already reads—an internal endpoint, a local database, a language-server RPC—and the UI labels each reading as official, derived, or manual so it never pretends a vendor blessed the number. When an adapter breaks, the ring degrades to a visible stale or error state instead of inventing a percentage.

Key highlights

• Borrows credentials from eight providers (Claude Code, Cursor, Codex, Antigravity, GLM, Grok, OpenCode, GitHub Copilot) without its own sign-in flow.
• Detects multiple Claude Code profiles automatically—any ~/.claude-<slug> directory gets its own ring with independent limits and sessions.
• Snaps to the usable screen edge, matching the physical MacBook notch shape when parked at the top.
• Alerts at 80% and 100% usage via standard macOS notifications, with per-provider mute toggles.
• Auto-updates silently via Sparkle with EdDSA-signed builds.

Caveats

• Every data source is an unofficial or internal API that can change without notice; the app is upfront that it may break.
• Keychain access for some providers requires a stable Developer ID signature, and Claude Code’s token rotation creates new keychain items that can silently revoke prior access grants.
• Raising a finished session to the foreground jumps to the app, not the exact terminal tab, because there is no universal scripting interface across Terminal.app, iTerm2, Warp, and Ghostty.

Verdict

Grab it if you juggle multiple AI coding assistants and want a persistent, honest tally of your remaining quota without managing another set of credentials. Skip it if you only use one tool with a generous limit, or if a potentially fragile adapter breaking mid-deadline would ruin your day.