https://github.com/Dwtexe/cursor-stats
A Cursor extension that displays your Cursor Subscription usage statistics in the status bar.
https://github.com/Dwtexe/cursor-stats
cursor cursor-ai cursor-ai-editor cursor-ide
Last synced: over 1 year ago
JSON representation
A Cursor extension that displays your Cursor Subscription usage statistics in the status bar.
- Host: GitHub
- URL: https://github.com/Dwtexe/cursor-stats
- Owner: Dwtexe
- License: mit
- Created: 2025-02-02T14:34:23.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-14T20:54:11.000Z (over 1 year ago)
- Last Synced: 2025-02-14T21:32:50.977Z (over 1 year ago)
- Topics: cursor, cursor-ai, cursor-ai-editor, cursor-ide
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=Dwtexe.cursor-stats
- Size: 25.5 MB
- Stars: 23
- Watchers: 2
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
- 👥 Team usage tracking with per-user statistics
- 📊 Premium request tracking with startOfMonth support
- 💰 Usage-based pricing information with billing cycle awareness
- 🔄 Smart cooldown and update mechanisms
- 🔔 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 with optimized performance
- 🎨 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](https://marketplace.visualstudio.com/items?itemName=Dwtexe.cursor-stats)
### Manual Installation
1. Download the latest .vsix file from [Releases](https://github.com/Dwtexe/cursor-stats/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](https://github.com/Dwtexe/cursor-stats/issues)
2. Submit a new issue if needed
3. Join the discussion in existing issues
## License
[MIT](LICENSE)