Codenotch — Development skill for Claude Code
A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.
How to install Codenotch
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open vinzdg/codenotch and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Codenotch does
A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.
Alternatives in Development
- Chops — 1,000+ macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp 1.1k ★
- Oh My Agent — Portable multi-agent harness for .agents-based skills, workflows, and standards-aware agent teams across Antig 786 ★
- HERO Anti OverDefense — HERO = Hashing · Edge cases · Rubrics · Overbuild — the four shapes coding agents over-defend in 333 ★
README
[](https://github.com/vinzdg/codenotch/actions/workflows/ci.yml)   
**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
[**Latest release**](../../releases/latest) — signed, notarized, and updating itself from then on. Take this one unless you have a reason not to.
To try unreleased `main` without an Xcode install, the [preview build](../../releases/tag/preview) is rebuilt from every commit, and the Package workflow keeps a per-commit disk image on each of its [runs](../../actions/workflows/package.yml). 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.appIf 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](#building).
Windows
A Windows port — Rust/Tauri 2, same design and providers — lives in [`windows/`](windows/README.md).
What it reads
| Provider | Source | How |
|---|---|---|
| Claude Code | official | Claude Code's own `/usag |
Related Skills
Agent Screensaver
A macOS screen saver that shows what your coding agents are doing: Claude Code, Codex and Cursor. See who need
Brink
Know when you're on the brink — Claude Code & Codex usage limits on the edge of your Mac screen
GenAIUsageWidget
Windows/Linux tray + desktop widget for Claude / Codex / Cursor / Antigravity usage limits (inspired by CodexB
Piaz Switch
Switch between Claude Code and Codex accounts in one click, track each account's limits, and see token usage a
Token Bar
macOS menu-bar app: token usage, cost & rate limits for Claude Code, Codex CLI, Gemini CLI
Modeldeck
macOS menu bar app that tracks usage limits across all your Claude Code and Codex CLI accounts — live "% left"
Related Agents
Design Workbench
macOS Workbench Designer on the Atlas bench. Owns installed-app proof, the 14-inch first viewport, wide-screen
Paf Reviewer
Runs one phone-a-friend relay or review command in the background and reports back a receipt plus the findings
Security Sentinel
Deep security review focused on OWASP Top 10, injection, auth/authz, data exposure, and dependency vulnerabili
