vinzdg

codenotchv1.26.0

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

vinzdg/codenotchDeveloper ToolsWindowsmacOS

3.1k

Stars

11.1k

Total downloads

10

Versions

6h ago

Page synced

Download

v1.26.02026-11-21 · 1d ago

Windows — all files

Codenotch-Setup.exe

3.5 MB47 downloadsSHA256 378ea40da9…
Download

About this project

Codenotch is a desktop utility that pins a compact status bar to the edge of the screen and uses rings to show remaining usage and reset times for AI coding assistants. Hover over a ring for the current limit windows; the Claude indicator uses the same active session window shown by Claude Code’s /usage command. Status markers show whether an assistant is working, finished, or waiting for input.\n\nIt reads official data sources for Claude Code, Cursor, Codex, Antigravity, DeepSeek, DeepSeek Harness, GLM, and others, including balances, recent token and cost totals, and request counts. Alongside macOS, Windows is available, plus iOS and Android companion apps. Pair a phone by scanning a code on the same local network to see the same usage percentages and reset times. Pairing codes expire after five minutes, and the service accepts local-network connections only.

Key features

  • Screen-edge rings show remaining usage
  • Displays limit windows and reset times
  • Shows whether an assistant is working or waiting
  • Supports Claude, Cursor, and other providers
  • Phone companion pairs over the local network
  • Also available for Windows

Use cases & who it is for

  • Keep an eye on remaining quota when you subscribe to several AI coding tools at once
  • Plan heavy tasks around limit-window reset times shown at a glance
  • Check each assistant's usage and reset times from your phone while away from the desk
  • See instantly whether an assistant is working, finished, or waiting for your input

Maintenance

Actively maintained

Last release 1d ago

License

MIT

Permissive license

Allows:Commercial use、Modification、Distribution
Requires:Keep the copyright notice

Facts

Language
Swift
Forks
512
Latest release
2026-11-21
Created
2026-09-05

System requirements & installation

Supported systems
Windows, macOS (based on the files the latest release actually ships)
How to install

Windows: Download the .exe or .msi installer, run it and follow the setup wizard.

macOS: Open the .dmg and drag the app into Applications; if macOS blocks the first launch, allow it under System Settings → Privacy & Security.

FAQ

Is Codenotch free?

Yes. Codenotch is free and open source under the MIT license, and its source code is public on GitHub.

Which systems does Codenotch support?

Codenotch is available for macOS and Windows, with iOS and Android companion apps for checking usage from your phone.

Is the usage data shown by Codenotch accurate?

It reads each tool's official data sources. For Claude, its ring reflects the same active session window shown by Claude Code's built-in /usage command, so the numbers use the same basis.

Where can I download the official version of Codenotch?

This page provides the official GitHub download link plus accelerated mirror downloads; the files are identical to the official release and include SHA256 checksums for verification.

Older versions 8 versions

v1.25.02026-11-06 · 2 filesGitHub release page
v1.24.02026-10-24 · 2 filesGitHub release page
v1.23.02026-10-14 · 2 filesGitHub release page
v1.22.02026-10-06 · 2 filesGitHub release page
v1.21.02026-10-02 · 2 filesGitHub release page
v1.20.02026-09-30 · 2 filesGitHub release page
v1.19.02026-09-28 · 2 filesGitHub release page
v1.18.02026-09-24 · 2 filesGitHub release page

Related software