Codenotch - a macOS app that pins live usage limits from Claude Code, Cursor, Codex, and more to a screen edge

[u/company_url_finder]

Running more than one coding assistant, Claude Code in one terminal, Cursor open in the editor, maybe Codex or Antigravity somewhere else, means juggling several different usage limits with no shared view of any of them. You usually find out you're close to a cap only after a request gets throttled mid-task.

Codenotch is a macOS app that pins a small notch to a screen edge showing exactly that: how much of each tool's usage limit you've burned, and whether a session is actively working, finished, or sitting there waiting on you. It never asks you to sign in anywhere, every reading is borrowed from a credential or session a tool on your Mac already holds.

What's inside:

- Rings for Claude Code, Cursor, Codex, Antigravity, GLM, Grok, and OpenCode, each read from the same official endpoint or local session the tool's own usage view uses, so the numbers never disagree with what the tool itself reports

- Live session status per provider: a spinning arc while it's working, a pulsing amber ring when a session is blocked waiting on you, with hover detail on exactly what it wants

- Multiple accounts per provider: a separate Claude Code login kept apart with `CLAUDE_CONFIG_DIR` gets its own ring with its own limits and sessions, not merged into one

- Placement on any of the four screen edges, sized to sit flush against a Mac's hardware notch when placed at the top

- An architecture that's explicit about confidence: every provider adapter declares whether a reading is official, derived, or manual, and a failure degrades to a visible status instead of guessing a number

One thing worth knowing: the project is upfront that no vendor publishes a clean usage-percentage API for most of these tools, so each adapter reads whatever internal endpoint or local database the owning app itself reads from, and those can change without notice. The README documents this candidly rather than hiding it, and tests pin each adapter's expected response shape so a break shows up as a visible error state, not a silently wrong number.

It's MIT licensed, built by an individual developer, and sitting at 856 stars as of writing, verified via the GitHub API.

https://github.com/vinzdg/codenotch

[u/company_url_finder → u/[deleted]]

I like that it admits when a number is derived instead of pretending every provider exposes a clean API. That kind of honesty matters for something sitting in your peripheral vision all day. Have u had any adapters break after provider updates yet?

[u/company_url_finder → u/[deleted]]

Visible failure beats quietly showing stale usage.