vinzdg/codenotch

A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.

Open original source ↗

Older snapshot: check the original source for current information.

From the publisher

README & documentation

Source preview

Read the project’s overview, installation instructions and usage examples. The original README is the source of truth.

[](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. [](../../releases/latest/download/Codenotch.dmg) 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…

vinzdg/codenotch on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-10-30T04:29:25.027Z

Inside the original README — Document outline
  1. Download
  2. Windows
  3. Connect your phone
  4. What it reads
  5. When a session ends
  6. Alerts
  7. Placement
  8. Updates
  9. Building
  10. Architecture
  11. The honest caveat
  12. Contributing

Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.

Links from the README

References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.

Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.

What this repository does

A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.

Repository facts

Owner
vinzdg
Primary language
Swift
Stars
2,726
Forks
432
Open issues + pull requests
55
License
MIT
Archived
No
Default branch
main
Created
2026-09-05T14:55:35.000Z
Last push
2026-10-02T09:04:42.000Z

Topics and intended use

No topics were included in the latest source metadata.

Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.

Evaluate before installing

Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-10-05T12:06:53.112Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

krahets/hello-algo

vorssaint/vorssaint-utils

manaflow-ai/cmux

robbietilton/Compositor

Lakr233/vphone-cli

xtool-org/xtool