OpenMacApps

Codenotch

Notch-style overlay with a usage ring per AI coding tool, plus an alert when an agent finishes or is waiting for you.

MIT · Free download · Downloads from github.com

License
MIT
Open source
Category
Developer tools
Source
GitHub
vinzdg
Verified
2026

About Codenotch

Codenotch pins a small black notch to any edge of the screen with one ring per AI coding service, filled by how much of the current usage window is spent; hovering a ring shows each limit and when it resets. It covers Claude Code, Codex, Cursor, GitHub Copilot, Antigravity, Grok, Kimi, Amp and others, plus local models in Ollama, LM Studio and oMLX. Most providers are read with the sign-in the tool already keeps on the Mac, so there is no separate login; a few use a pasted key or an in-app web sign-in.

It is meant for developers who switch between several coding agents and their limits. A turning arc inside a ring means a session is still working, an amber ring means it is waiting for you, and the notch opens briefly with a sound when an agent stops. Notifications fire when a limit passes 80% and 100%, the menu bar item can show five-hour limits as text, and a phone companion app can pair over the local network.

Codenotch needs macOS 15 or later and is a universal build. Releases are signed and notarized and install updates in the background through Sparkle unless you switch that off. No provider publishes an official usage API, so readings come from internal endpoints, local caches and keychain items that can change without notice; reading a token from the keychain may prompt for access. A Windows port is built from the same repository.

Information

Source code
vinzdg/codenotch
License
MIT
Website
github.com
Download
github.com
Category
Developer tools
Topics
Menu bar apps, Notch apps
Evidence checked

OpenMacApps links to each project’s official download. Check its release notes for macOS version and Apple silicon support. The verification date records our license and source review, not a security audit. Read how we verify.

Sources and image credits

License and artwork notices

Improve this listing

For the Developer

Link to this page from your README with a badge.

Listed on OpenMacApps
[![Listed on OpenMacApps](https://openmacapps.com/badge.svg)](https://openmacapps.com/apps/codenotch/)
See All You Might Also Like