Repository navigation
Releases: kidchenko/cota
Release list
Cota 0.0.3
Full Changelog: v0.0.2...v0.0.3
Cota 0.0.2
Cota 0.0.1
Your Claude usage limits, in the Windows tray. A ring that fills as your
fullest limit does, so you find out you are near the wall before you hit it
rather than mid-task.
Landing page: https://josebarbosa.dev/cota/
Install
winget install kidchenko.Cota
# or
choco install cotaOr take Cota-Setup-0.0.1.exe below, or cota-0.0.1-x64.exe to run without
installing.
Prefer the installer if you want toasts to say "Cota": Windows resolves a
notification's name from an AppUserModelID registered against a Start Menu
shortcut, and only the installer creates one. A portable copy falls back to
borrowing PowerShell's registration.
The binary is not code-signed, so SmartScreen warns on first run. Click
More info, then Run anyway.
What it does
- Every bucket. Session, weekly, and any per-model limit, each with the
time until it resets. - Tells you when you will run out. At this rate: full in 3h 20m, fitted
from the slope of your own usage rather than from counting local tokens —
subscription buckets are opaque server-side counters, so a token total is a
proxy whose error cannot be bounded. - Says where the week went. Which project ate it, read from the transcripts
already on your disk. Labelled as an estimate, because it is one. - Interrupts rarely. Toasts at 50%, 80% and 95%, once each per limit per
window, and when a limit you were actually near resets.
Requirements
Windows 10 or later, x64, and Claude Code signed in at least once on this
machine. Cota reads the token Claude Code already stores, never asks for a
credential of its own, and talks to api.anthropic.com and nowhere else.
Notes
The usage endpoint is undocumented and will change. Cota is written for that:
every field optional, unknown fields ignored, a fallback for the older response
shape, and the server's severity grading taken as a floor rather than gospel.
When it does break the ring goes to a grey dashed circle and the menu says why,
rather than showing a number that is quietly wrong.
Checksums (SHA-256)
Cota-Setup-0.0.1.exe 47a89bcdb535fae6fd0f845164c7873b3e34af77edc6094149392009c5a0ad38
cota-0.0.1-x64.exe 4f0b3990f9fe19b7fc11b931913f8d0627550c453d02f49c9fc7318fe9bac6a5