v0.1.0 — Cursor Usage
First release of Cursor Usage — a tiny, read-only VS Code / Cursor extension that shows your live Cursor usage with no separate login.
Install
Download cursor-usage-0.1.0.vsix below, then:
- Command Palette → Extensions: Install from VSIX… → select the file, or
- CLI:
cursor --install-extension cursor-usage-0.1.0.vsix
Reload the window and the badge appears at the bottom-right.
Features
- Status-bar badge (two adjacent items):
⏲ used/limitand$used/$cap, each colored independently white → amber (≥80%) → red (≥100%). Click to open details. - Adaptive sidebar panel: included requests (used/limit, %, remaining, progress bar, reset date + days left), on-demand spend, burn-rate line, and an optional per-model table for team accounts.
- Compact ↔ full layout by panel height; click a card in compact mode to expand.
- Reconnect hint when the token is missing/expired.
- Theme-adaptive (light / dark / high-contrast).
Authentication
Reads Cursor's own local session token read-only from state.vscdb (only the cursorAuth/* keys) and builds the WorkosCursorSessionToken cookie in memory. Nothing is logged or persisted. Requires the sqlite3 CLI on PATH.
Caveats
Uses undocumented internal cursor.com endpoints (may change). Personal, read-only use.