Claude Code usage

CodeNotch

macOS app pinning Claude Code and other agent usage limits to a screen edge.

2,990 stars 489 forksUsage & cost trackers Source

Install

Install
brew install xcodegen create-dmg   # once
From source
git clone https://github.com/vinzdg/codenotch.git

From the README

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:

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…
Read the full README on GitHub

Details

Language
Swift
License
MIT
Last updated
24 October 2026

FAQ

What is CodeNotch?

macOS app pinning Claude Code and other agent usage limits to a screen edge. It is a usage for Claude Code, from vinzdg/codenotch on GitHub.

How do I install CodeNotch?

Run brew install xcodegen create-dmg # once, then follow the setup in the README.

Is CodeNotch popular?

vinzdg/codenotch has 2,990 GitHub stars and 489 forks, and is included in 1 curated Claude Code list. It was last updated on 24 October 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.