A macOS app that pins a small black notch to a screen edge, showing how much
of each coding assistant's usage limit you have burned — and whether it is
still working, done, or waiting on you.
Hover a ring for its limit windows and when they reset. Claude's ring shows the
same current session window Claude Code's own /usage leads with, so the
two never disagree.
Download
That button is the disk image itself, not the page it sits on — the asset is
named Codenotch.dmg in every release, so releases/latest/download/ always
resolves to the newest one and the link never needs updating. Signed,
notarized, and updating itself from then on. Take this one unless you have a
reason not to; the release page has the notes.
To try unreleased main without an Xcode install, the preview
build is rebuilt from every commit, and the
Package workflow keeps a per-commit disk image on each of its
runs. Neither is notarized — they are
ad-hoc signed, because the Developer ID certificate exists on one machine — so
macOS quarantines the download. Clear the flag once, after dragging the app to
Applications:
xattr -dr com.apple.quarantine /Applications/Codenotch.app
If macOS says the app is damaged, that is the quarantine flag rather than a bad download — run the command above.
Universal binary. macOS 15 or later. To build and install a copy from source
instead, see Building.
Windows
A Windows port — Rust/Tauri 2, same design and providers — lives in windows/.
The button is the installer itself, named Codenotch-Setup.exe in every release for the same
reason the dmg keeps one name. It installs for the current user without administrator rights,
and fetches WebView2 if Windows does not already have it.
The installer is not code-signed, so the first time it runs SmartScreen says Windows protected
your PC. Choose More info, then Run anyway. Every Windows change also leaves an
installer on its Windows Package run.
Connect your phone
The Codenotch phone app (iOS and Android) can show the same usage
percentages, reset times and session states as the notch on your Mac.
It reads only what the notch already displays — never tokens, credentials
or raw API responses.
To pair, open Settings › Phone › Connect a Phone… (or the menu item)
on your Mac. A QR code appears with a five-minute countdown; scan it with
the Codenotch phone app, or copy the link and paste it into the app. The
Mac and phone must be on the same Wi-Fi network — the server answers only
local-network addresses and rejects anything routed over the internet.
Each code is single-use and expires after five minutes. Reopening the
window always mints a fresh one.
To remove a paired phone, open Settings › Phone, find the device in
the list and click Remove. Its credentials are deleted immediately and
any subsequent request from that phone is rejected.
See docs/phone-link-protocol.md for the
wire-level details.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
