vinzdg

Codenotch — Development skill for Claude Code

Development community

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 ★
  • Claude Auto Resume — A shell script utility that automatically resumes Claude CLI tasks when usage limits are lifted 732 ★

README

![Codenotch](docs/design/codenotch-banner.png)

[![CI](https://github.com/vinzdg/codenotch/actions/workflows/ci.yml/badge.svg)](https://github.com/vinzdg/codenotch/actions/workflows/ci.yml) ![Platform](https://img.shields.io/badge/platform-macOS%2026%2B-black) ![Swift](https://img.shields.io/badge/swift-5-orange) ![License](https://img.shields.io/badge/license-MIT-green)

**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.**

![Collapsed notch with hover tooltip](docs/design/frame-124-hover-tooltip.png)

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.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](#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