ClaudeMap

Codenotch

A macOS notch app that shows how much of each coding assistant's usage limit you've burned — Claude Code, Cursor, Codex, and more at a glance.

SDKs & Toolingmacosusage-trackingmonitoringdesktop-app
Visit projectvinzdg/codenotch

Codenotch pins a small notch to a screen edge and draws one ring per coding assistant's usage limit: Claude Code reads the official /usage endpoint (falling back to the OAuth token Claude Code itself uses), Cursor and Codex read their local sign-ins, so numbers match what each tool reports. Hover a ring for limit windows and reset times, and its shape shows whether the assistant is working, done, or waiting on you. Official builds ship as a signed DMG with Sparkle auto-update; a Rust/Tauri Windows port lives in the same repo.

What it does

  • One ring per assistant — 9 providers including Claude Code, Cursor, Codex, Antigravity, GLM, Grok, and GitHub Copilot
  • Claude Code data comes from the official /usage endpoint the CLI itself leads with, so app and CLI never disagree
  • Ring shape doubles as a status light: working, done, or waiting on your input
  • EdDSA-signed Sparkle auto-updates; a Rust/Tauri Windows port lives in windows/

When to use it

For anyone running multiple coding assistants against weekly or five-hour limits who is tired of discovering the wall by hitting it.

Getting started

# Download Codenotch.dmg from GitHub Releases (v1.6.0 at time of writing)
open https://github.com/vinzdg/codenotch/releases/latest

# Build from source instead:
brew install xcodegen
make run

Things to know

macOS 26+ only for the native app. Claude's ring shows the current-session window (same as /usage), not the weekly window. Debug builds are ad-hoc signed, so macOS re-prompts for keychain access on every launch — use the released DMG.

Repository

vinzdg/codenotch

Charted

Related on the map

  • Harness Bridge

    SDK / Tool

    A local launcher that points Claude Code and seven other coding harnesses at any OpenAI-, Anthropic- or Responses-compatible endpoint — without editing a single config file.

    • launcher
    • local-models
    • cli
    • menu-bar
    View

  • Claude for Siri

    SDK / Tool

    Answers macOS Spotlight and Siri prompts with your signed-in Claude Code account — an experimental macOS 27 model-delegation provider.

    • macos
    • siri
    • spotlight
    • model-delegation
    View

  • AI Coding Assistant Data Extractor

    SDK / Tool

    Extract your own local chat history from ten AI coding assistants into one normalized JSONL — for fine-tuning, analytics, or backing up years of conversations. Standard library only.

    • cli
    • data-export
    • jsonl
    • backup
    View