Cursor Stats Extension

A VS Code extension that provides real-time statistics about your Cursor usage, including premium requests and usage-based pricing information.

Features

• 🚀 Real-time monitoring of Cursor usage
• 📊 Premium request tracking with startOfMonth support
• 💰 Usage-based pricing information with billing cycle awareness
• 🔔 Smart notification system with configurable thresholds
• 💸 Spending alerts with dollar amount thresholds
• 💳 Mid-month payment tracking and invoice notifications
• 🔒 Stripe integration for billing portal access
• 🖥️ Focus-aware updates (pauses when window minimized)
• 🎨 Customizable status bar display with optional colors
• 📝 Detailed tooltips with usage statistics
• 📈 Total request counter (fast + usage-based requests)
• ⚡ Command palette integration
• 🌙 Support for both regular and nightly Cursor versions
• 🔄 Enhanced GitHub release updates with markdown support

Upcoming Features

Stay tuned for these exciting new features coming soon:

• 📊 Session based request tracking
• 📈 Visual analytics with graphs for historical request usage
• 🎯 Project-specific request usage monitoring
• 🎨 Dedicated activity bar section for enhanced statistics view
• 🔄 Smart API error handling:
  • Automatic retry reduction during outages
  • Intelligent refresh rate adjustment
  • User-friendly error notifications
• ⚙️ Enhanced customization features:
  • Configurable quota display options
  • Hide/show specific model statistics
  • Customizable status bar information

Images

UI	UI	Settings

Installation

VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Cursor Stats"
4. Click Install

• Or install from VS Code Marketplace

Manual Installation

1. Download the latest .vsix file from Releases
2. Open Cursor
3. Press Ctrl+Shift+P (Cmd+Shift+P on macOS)
4. Type 'Install from VSIX' and select it
5. Choose the downloaded VSIX file

Project Structure

The project is organized into the following directories:

cursor-stats/
├── src/
│   ├── interfaces/      # TypeScript interfaces and types
│   │   └── types.ts
│   ├── services/       # Core services for different functionalities
│   │   ├── api.ts      # API communication with Cursor servers
│   │   ├── database.ts # SQLite database operations
│   │   └── github.ts   # GitHub release checking
│   ├── handlers/       # UI and event handlers
│   │   ├── statusBar.ts # Status bar UI management
│   │   └── notifications.ts # Smart notification system
│   ├── utils/          # Utility functions
│   │   └── logger.ts   # Logging functionality
│   └── extension.ts    # Main extension file

Configuration

The extension can be configured through VS Code settings:

• cursorStats.enableLogging: Enable detailed logging for debugging
• cursorStats.enableStatusBarColors: Toggle colored status bar based on usage
• cursorStats.enableAlerts: Enable usage alert notifications
• cursorStats.showTotalRequests: Display total requests instead of current usage
• cursorStats.usageAlertThresholds: Configure percentage thresholds for alerts
• cursorStats.refreshInterval: Set update frequency
• cursorStats.spendingAlertThreshold: Configure dollar amount thresholds for spending alerts

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Support

If you encounter any issues or have suggestions, please:

1. Check our Known Issues
2. Submit a new issue if needed
3. Join the discussion in existing issues

License

MIT