vinzdg/codenotch

What it solves

Codenotch is a macOS app that provides a persistent, unobtrusive visual indicator of your AI coding assistant usage limits. It solves the problem of having to manually check usage quotas for multiple different AI tools (like Claude Code, Cursor, and Grok) across different accounts, allowing developers to see at a glance how much of their limit has been consumed and whether a tool is currently active or waiting for user input.

How it works

The app pins a small "notch" to the screen edge that unfolds upon hover. It does not manage its own logins; instead, it borrows credentials and session data from the tools already installed on the Mac (e.g., reading from local SQLite databases, OAuth tokens in the keychain, or internal endpoints).

• Usage Tracking: It polls various provider endpoints using borrowed credentials to fetch current usage percentages and reset windows.
• Status Monitoring: It tracks whether a session is busy (spinning arc) or blocked (pulsing amber ring).
• Multi-Account Support: It supports multiple logins for tools like Claude Code by detecting separate configuration directories.
• Placement: The notch can be placed on any of the four screen edges, with a specific design that integrates with the hardware notch on newer Macs.

Who it’s for

Developers who use multiple AI coding assistants and need to track their usage limits and session statuses without leaving their editor or switching windows.

Highlights

• Zero-Login Setup: No separate sign-in required; it automatically detects and uses existing sessions from installed AI tools.
• Broad Provider Support: Supports Claude Code, Cursor, Codex, Antigravity, GLM, and Grok.
• Fidelity Tracking: Clearly distinguishes between official vendor data and derived or manual estimates.
• Multi-Account Handling: Supports multiple separate accounts for the same provider (e.g., work vs. personal).
• Native macOS Integration: Integrates with the hardware notch and the usable screen edges, including the Dock.
• Automatic Updates: Uses Sparkle for signed, background updates.