A Windows port of Codenotch — the usage notch that sits on the edge of your screen and answers two questions at a glance: how much of my AI allowance is left, and is Claude still working.
Same design language as the macOS original (inverse-rounded pill, colour-graded rings, hover card with per-window bars), rebuilt for Windows in Rust + Tauri 2 / WebView2. No code is copied from the Swift app; the providers are reimplemented from their documented behaviour and the wire formats.
| Cell | Source | How it reads it |
|---|---|---|
| Claude | GET https://api.anthropic.com/api/oauth/usage with the token Claude Code keeps in ~/.claude/.credentials.json |
Session / weekly windows, 429 back-off with a persisted deadline, stale readings dimmed with their age. A thin arc spins inside the ring while a Claude session is working, and pulses amber when one is waiting on you (Claude Code hooks + transcript watcher, desktop app included). |
| Codex | The local Codex sign-in in ~/.codex/auth.json (read only, never refreshed), falling back to the newest session snapshot |
Live primary/secondary windows (5h + weekly on paid plans, a monthly window on free) while Codex is signed in; Spark and Code review appear on the hover card when Codex reports them; otherwise the last snapshot, marked stale by its own timestamp. |
| Cursor | The editor's own session from state.vscdb → cursor.com/api/usage-summary |
Included usage / API usage / on-demand, reset at billing-cycle end. Nothing to sign into: it borrows the editor's session, so there is only ever one account. |
| Antigravity | Official agy CLI /usage print when installed; otherwise the existing local language_server bridge, Google Cloud Code API, or transcript model count |
Official four quota rows (Gemini & Claude/GPT 5h/weekly) without running the full IDE. When CLI is absent, falls back to legacy local bridge/API. |
Providers that are not installed simply do not get a cell.
- Official CLI (Preferred): When the official Antigravity CLI (
agy.exe) is installed (%LOCALAPPDATA%\agy\bin\agy.exeor onPATH) and signed in, Codenotch reads official quotas directly without keeping the full IDE running. - Execution: Runs the official CLI in a hidden Windows pseudo-console, with a 70-second timeout and cleanup of its process tree. It does not need PowerShell scripts or a separate service.
- Refresh: Checks at startup and on hover/explicit request when readings are at least five minutes old; failed attempts are also limited to once per five minutes. It keeps previous readings on failure, without switching to legacy APIs. The CLI is not launched periodically while idle.
- Fallback: When the official CLI is not installed, Codenotch preserves the legacy local bridge (
language_server), Credential Manager, and transcript model turn counting to maintain compatibility with existing installations. - Official CLI Reference: Standalone
/usageprinting is described in the official Antigravity CLI documentation. Note: no categorical Terms of Service guarantee is made.
Restart Codenotch after installing or removing agy: the source is selected at startup.
The CLI's text report is parsed defensively; an unsupported format or failed sign-in
shows an error or the last reading marked stale. Codenotch does not automate sign-in.
Prerequisites: Rust (MSVC toolchain), WebView2 runtime (ships with Windows 11).
# from this directory (the repo root here; `windows/` inside the upstream repo)
cargo build --release
.\target\release\codenotch.exe # pill appears on the right edge of the primary monitor
.\target\release\codenotch.exe doctor # self-diagnosis: credentials, data sources, icons, hooksTray menu: Settings…, Refresh usage now, Quit. Everything else is in the settings
window: the taskbar icon, which rings the notch shows, its size, start with Windows, the
language, Claude Code hooks, reset position, and the data folder (%APPDATA%\codenotch —
logs, persisted readings, icon overrides).
Provider marks are the SVGs from @lobehub/icons-static-svg
(MIT), embedded unmodified — see codenotch/glyphs/NOTICE.md. Drop your own
claude|codex|cursor|gemini.svg (or .png) into %APPDATA%\codenotch\glyphs\ to override.
The marks remain the trademarks of their owners.
.
├── codenotch/ the Windows app (pill, hover card, settings, providers)
└── codenotch-hook/ tiny helper Claude Code calls to report session events
A pull request that touches this tree is built and tested; the check is skipped inside forks until the pull request is opened here.
This port follows the upstream design and provider semantics. It is developed at
Im-Midi/codenotch-windows and offered to the
upstream project as its windows/ tree; the two are kept in sync. Session detection
originated in Im-Midi/Pac-Man (MIT).
MIT — see LICENSE. The Codenotch design and name belong to the upstream author.