Cursor Usage

Track your remaining Cursor fast-premium requests and usage-based spending directly in your Cursor's status bar with intelligent reset tracking and usage analytics.

What It Gives You

This extension displays your remaining Cursor fast-premium requests count in Cursor's status bar, with usage-based spending information shown when you've exhausted your included requests. It now includes intelligent reset date tracking and daily usage analytics to help you better manage your AI usage. Think of it as your personal AI usage speedometer with financial tracking and predictive insights.

• Real-time tracking: See your remaining requests at a glance (e.g., ⚡ 247)
• Smart reset tracking: Know exactly when your quota resets and how many days remain
• Usage analytics: Daily usage rate tracking and quota exhaustion predictions
• Smart transitions: When requests are exhausted, seamlessly shows spending vs limit (e.g., $1.52/$150.00)
• Smart color coding: Visual warnings when you're running low on requests or approaching spend limits
• Enhanced tooltips: Comprehensive breakdown with reset dates, usage patterns, and predictive warnings
• Click to refresh: Quick manual refresh by clicking the status bar
• Automatic updates: Configurable polling to keep data fresh

Cursor Quota Checker VS Code Extension

Track your remaining Cursor fast-premium requests in the status bar, with usage-based spending shown when exhausted.

This extension helps you keep track of your fast-premium requests quota on Cursor. It displays the remaining requests in the status bar and changes color to warn you when you are running low. When you run out of fast requests, it switches to tracking your usage-based spending to help you stay within budget.

Features

• Real-time Quota Tracking: Displays remaining fast-premium requests in the status bar.
• Spending Tracker: Automatically switches to showing your usage-based spending (in dollars) when you run out of fast requests.
• Visual Warnings:
  • ⚡ Green/Normal: Plenty of requests remaining.
  • ⚠️ Yellow: Low on requests (< 10%) or approaching spending limit (> 80%).
  • 🔴 Red: No requests left or spending limit reached (matches your hard limit).
• Detailed Tooltip: Hover over the status bar item to see:
  • Exact number of requests remaining.
  • Percentage used.
  • Time until next monthly reset.
  • Average daily usage.
  • Spending details: Amount spent vs. hard limit.
• Auto-Refresh: Automatically refreshes usage data every 30 minutes (configurable).
• Team Support: Supports both individual users and team accounts. Auto-detects your team or lets you specify a Team ID.
• Secure: Stores your session cookie securely using VS Code's SecretStorage API.

How It Works

The extension authenticates with Cursor's API using your browser session cookie and uses a two-tier approach to provide usage insights:

For Team Users: Fetches both individual user data (for reset dates and limits) and team usage data (for actual usage counts and spending), then combines them for comprehensive insights.

For Individual Users: Uses your personal usage data directly from Cursor's individual user API, showing request counts and reset dates.

The extension gracefully falls back to individual data if team information is unavailable, ensuring it works for all users regardless of their Cursor setup.

Visual Status Indicators:

When showing requests (remainingRequests > 0):

• 🟢 Normal: Plenty of requests remaining (>10%)
• 🟡 Warning: Low on requests (≤10% remaining, yellow background)

When showing spending (0 requests left):

• 🟢 Normal: Spending well below limit (<80%)
• 🟡 Warning: Approaching spend limit (≥80%, yellow background)
• 🔴 Critical: Spend limit reached or exceeded (red background)

Status Bar Display Logic:

• ⚡ 247 - 247 fast-premium requests remaining (normal state)
• ⚠️ 15 - Warning: low requests remaining (≤10%)
• ⚡ $1.52/$150.00 - No requests left, normal spending (green)
• ⚠️ $120.50/$150.00 - No requests left, approaching limit (yellow)
• ❌ $150.00/$150.00 - No requests left, limit reached (red)

Setup

Step 1: Get Your Session Token

You need to extract your WorkosCursorSessionToken cookie from your browser:

For Chrome/Edge:

1. Go to cursor.com and log in
2. Press F12 or right-click anywhere → Inspect
3. Click the Application tab at the top
4. In the left sidebar, expand Cookies → click https://cursor.com
5. Find the cookie named WorkosCursorSessionToken
6. Double-click the Value column and copy the entire token

For Firefox:

1. Go to cursor.com and log in
2. Press F12 or right-click anywhere → Inspect Element
3. Click the Storage tab at the top
4. In the left sidebar, expand Cookies → click https://cursor.com
5. Find the cookie named WorkosCursorSessionToken
6. Double-click the Value column and copy the entire token

For Safari:

1. First, enable the Developer menu: Safari → Preferences → Advanced → check "Show Develop menu in menu bar"
2. Go to cursor.com and log in
3. Press ⌘+⌥+I to open Web Inspector
4. Click the Storage tab
5. Click Cookies → cursor.com
6. Find the cookie named WorkosCursorSessionToken
7. Double-click the Value column and copy the entire token

Step 2: Configure the Extension

1. Open VS Code Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
2. Run the command: Cursor Quota Checker: Insert cookie value
3. Click "Insert Token" (or click "Show Instructions" if you need help)
4. Paste your cookie value and press Enter

Step 3: Done!

The status bar will update with your remaining requests. You only need to do this once—the token is stored securely.

Configuration

You can customize the extension through VS Code settings:

Commands

All commands are available from the Command Palette (Cmd+Shift+P).

Tip: Click the status bar item to quickly refresh your usage data.

Detailed Tooltip Information

Hover over the status bar item to see comprehensive information:

When you have requests remaining:

Resets in 23 days (2024-02-15) · 8.7 requests/day avg

Fast Premium Requests: 247/500 remaining (50.6% used)
Spending: $1.52 of $150.00 limit (1.0% used)
Remaining budget: $148.48

When requests are exhausted:

Resets in 23 days (2024-02-15) · 21.7 requests/day avg

Fast Premium Requests: 0/500 remaining (100% used)
Spending: $1.52 of $150.00 limit (1.0% used)
Remaining budget: $148.48
⚠️ No requests remaining

With predictive warnings:

Resets in 23 days (2024-02-15) · 25.0 requests/day avg
⚠️ At current rate, quota exhausted in ~10 days

Fast Premium Requests: 250/500 remaining (50.0% used)
Spending: $0.00 of $150.00 limit (0.0% used)
Remaining budget: $150.00

Key tooltip features:

• Reset countdown: Shows exact reset date and days remaining
• Usage analytics: Daily average request consumption
• Predictive warnings: Alerts if you're likely to exhaust quota before reset
• Dynamic limits: Displays your actual plan limits (not hardcoded values)

Additional contextual warnings:

• ⚠️ Low on requests (≤10% remaining)
• ⚠️ Approaching spend limit (≥80% of budget used)
• ⚠️ No requests remaining
• ⚠️ Spend limit reached!
• ⚠️ At current rate, quota exhausted in ~X days

Security & Privacy

Your security is paramount, so here's exactly what happens with your data:

Why We Need Your Cookie

A fair question! Currently, Cursor's API only provides API tokens to users with "Admin" roles. This means that if you're a "Team Member," there's no official way to programmatically check your usage stats.

This extension bridges that gap by using the same session cookie your browser uses to talk to the Cursor dashboard. It's the only way to get you the usage data you need, right in your editor. We keep our fingers crossed that a more direct API will be available for everyone in the future!

Cookie Storage

• Your session cookie is stored using VS Code's SecretStorage API — the same secure mechanism used by official extensions
• The cookie never leaves your local machine except for direct API calls to Cursor
• It's encrypted and isolated from other extensions
• No logging or caching of sensitive data

Don't just take our word for it, though. This extension is fully open-source. Feel free to grab your magnifying glass, put on your detective hat, and inspect the code yourself :)

Data Usage

• We don't store anything: Your cookie and usage data never reach us
• Direct communication: Extension talks directly to cursor.com/api
• Minimal data: Only fetches essential usage information
• No tracking: Zero analytics, telemetry, or data collection

What Gets Sent

The extension only makes authenticated requests to these Cursor endpoints:

• /api/auth/me - to get your user information
• /api/usage?user=USER_ID - to get your individual usage data and reset dates
• /api/dashboard/teams - to get your team list
• /api/dashboard/team - to get your user ID within teams
• /api/dashboard/get-team-spend - to get team usage data

That's it. No third parties, no external services, no funny business.

Installation

This extension is available on Open VSX Registry (not VS Code Marketplace, since it's specifically for Cursor users).

1. Open Cursor
2. Go to Extensions panel
3. Search for "Cursor Usage"
4. Install and follow the setup steps above

Contributing

We welcome contributions! Here's how to get started:

Development Setup

This project uses Node.js v20. If you use nvm, you can run nvm use to automatically switch to the correct version.

1. Clone the repository

   git clone https://github.com/Sourabh10122002/cursor-quota-checker.git
   cd cursor-quota-checker
   

2. Install dependencies

   yarn install
   

3. Start the watcher

   yarn watch
   

4. Launch the debugger

   • Press F5 in VS Code to open the Extension Development Host.
   • This will run the extension in a new VS Code window, where you can test its functionality.
   • Check the Debug Console in your original editor window for logs.

Building for Release

# Compile TypeScript
yarn compile

# Package for distribution
vsce package

Troubleshooting

Status bar shows "Set Cookie"

• Your session cookie isn't set or has expired.
• Re-run the Cursor Quota Checker: Insert cookie value command.

Status bar shows "Refresh Failed"

• There may be a network connectivity issue or the Cursor API is down.
• Your cookie might have expired; try re-inserting it.
• Run the Cursor Quota Checker: Force Re-initialize command.

Spending information not showing

• Individual users: Spending data is only available for team users. Individual users will see request counts and reset dates only.
• Team users: Spending data (spendCents and hardLimitOverrideDollars) may not be available for all teams. Ensure your team has usage-based billing configured.
• The extension gracefully falls back to showing request counts when spending data is unavailable.

License

MIT License - feel free to fork, modify, and improve!

Made with ❤️ for the Cursor community. Because knowing your AI limits shouldn't require leaving your editor.