Cursor Usage
Display your Cursor AI request usage directly in the status bar with real-time model info and trend prediction.
Features
- Real-time usage display — Shows
⚡ 304/500 (used/total) in the status bar
- Color-coded warnings — Green (>30%), Yellow (10–30%), Red (<10%)
- Current model — Shows the most recently used model (e.g. Claude 4.6 Opus)
- Trend prediction — Daily average, projected monthly usage, days until exhaustion
- Exceeded protection — Correctly handles over-limit scenarios (no negative numbers)
- Auto-refresh — Updates every 5 minutes (configurable, minimum 60s)
- Click to refresh — Click the status bar item to refresh immediately
- Critical alert — Warning notification when usage drops below 10%
- Zero configuration — Automatically reads token from local Cursor database
Hover over the status bar item to see:
- Account plan & current model
- Usage breakdown (used / remaining / total)
- Trend analysis (daily avg, projected total, exhaustion forecast)
- Next billing cycle reset date
- Quick actions: Refresh & Settings
Installation
From VSIX (local)
cursor --install-extension cursor-usage-0.1.0.vsix --force
Or in Cursor: Cmd+Shift+P → Extensions: Install from VSIX...
From Marketplace
Search "Cursor Usage" in the Extensions panel.
Configuration
Open Settings (Cmd+,) and search cursorUsage:
| Setting |
Description |
Default |
cursorUsage.token |
Cursor accessToken (leave empty for auto-detection) |
"" (auto) |
cursorUsage.refreshInterval |
Refresh interval in seconds (minimum 60) |
300 |
Commands
| Command |
Description |
Cursor Usage: Refresh |
Manually refresh usage data |
Cursor Usage: Settings |
Open extension settings |
Cursor Usage: Diagnose |
Show diagnostic info (model data from Dashboard API) |
Requirements
- macOS (reads token from local Cursor database via
sqlite3)
- Cursor IDE with an active login
Privacy
- Token is read locally from your machine only
- Usage data is fetched from Cursor's API (
api2.cursor.sh)
- Model data is fetched from Cursor Dashboard API (
cursor.com)
- No data is sent to any third party
License
MIT
| |