Cursor Pulse

Elegant monitoring for Cursor AI subscription quota with clean status bar integration and rich analytics

✨ Features

• 🔄 Real-time Quota Monitoring - Track GPT-4 usage limits and usage-based pricing in your status bar
• 📊 Rich Analytics Dashboard - View detailed usage statistics, lines edited, and tabs accepted
• ⚡ Smart Caching - Faster loading with intelligent data storage and refresh
• 🎨 Visual Feedback - Smooth animations and intuitive status indicators
• 🔍 Comprehensive Tooltips - Hover for detailed quota information and recent activity
• ⚙️ Flexible Configuration - Customize refresh intervals, display options, and notification preferences
• 🛡️ Privacy-First Design - Read-only local database access, no third-party data collection
• 🔧 No Setup Required - Works on all platforms without additional dependencies

🚀 Installation

From VS Code / Cursor Marketplace

📦 Install from VS Code Marketplace

1. Open VS Code Extensions panel (Ctrl+Shift+X / Cmd+Shift+X)
2. Search for "Cursor Pulse"
3. Click Install

Or install directly from the Visual Studio Code Marketplace.

Alternative: GitHub Releases

📥 Download VSIX from GitHub Releases

1. Go to the Releases page
2. Download the latest .vsix file from the assets section
3. In Cursor: Ctrl+Shift+P / Cmd+Shift+P
4. Run command: Extensions: Install from VSIX...
5. Select the downloaded .vsix file

This method is useful when:

• 🔄 You want to install a specific version
• 🏢 Your organization restricts marketplace access
• 🧪 You want to test pre-release versions

Manual Installation

git clone https://github.com/lroolle/cursor-pulse.git
cd cursor-pulse
npm install
npm run package
# Install the generated .vsix file

💡 Usage

Status Bar Display

The extension displays your quota status directly in the VS Code status bar:

Available Commands

Access these commands via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Rich Tooltip Information

Hover over the status bar icon to see comprehensive usage details:

• Account Information - User details and subscription plan
• Usage Analytics - Lines edited, tabs accepted, and productivity metrics
• Recent Activity - Latest usage events and charges
• Quota Details - Current limits, reset periods, and usage trends
• Performance Stats - API response times and cache hit rates

⚙️ Configuration

Customize Cursor Pulse behavior through VS Code settings:

Core Settings

Analytics & Display

Advanced Settings

Quick Settings Access

1. Command Palette: Cursor Pulse: Open Settings
2. Settings UI: Go to File → Preferences → Settings → Extensions → Cursor Pulse
3. Settings JSON: Add configuration to your settings.json

{
  "cursorPulse.refreshInterval": 180,
  "cursorPulse.showPercentage": true,
  "cursorPulse.analyticsTimePeriod": "7d",
  "cursorPulse.enableNotifications": false
}

🔧 Requirements

• VS Code: Version 1.96.0 or higher
• Cursor AI: Active installation with valid session
• System: Read access to Cursor's local database
• Network: Internet connection for API calls

🛠️ Troubleshooting

Common Issues

Debug Mode

Enable detailed logging for troubleshooting:

1. Open Command Palette (Ctrl+Shift+P)
2. Run Cursor Pulse: Set Log Level
3. Select Debug level
4. Run Cursor Pulse: Show Logs to view output

Performance Optimization

• Minimum refresh interval: 60 seconds (enforced for API rate limiting)
• Smart caching: Automatically refreshes when needed
• Resource cleanup: Proper disposal of timers and event listeners

🔒 Privacy & Security

Cursor Pulse is designed with privacy as a core principle:

• ✅ Local Data Only - Reads from your local Cursor database safely
• ✅ No Third-Party Services - Direct communication with Cursor APIs only
• ✅ Read-Only Access - Never modifies your Cursor data or state database
• ✅ Safe Storage - Uses VSCode's extension storage, never modifies Cursor files
• ✅ Session Token Reuse - Uses your existing Cursor authentication
• ✅ No Data Collection - No telemetry or usage data sent anywhere

Data Access

The extension accesses:

• Local Cursor SQLite database (read-only)
• Cursor API endpoints for quota information
• VS Code workspace settings for configuration

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines.

Development Setup

# Clone and setup
git clone https://github.com/lroolle/cursor-pulse.git
cd cursor-pulse
npm install

# Development workflow
npm run watch          # Start development mode
npm test              # Run test suite
npm run lint          # Check code style
npm run package       # Build production version

# Debug in VS Code
# Press F5 to launch Extension Development Host

Project Structure

src/
├── extension.ts          # Main extension entry point
├── services/
│   ├── api.ts           # Cursor API client
│   ├── database.ts      # Local database interface
│   └── dataService.ts   # Data aggregation and caching
├── ui/
│   └── statusBar.ts     # Status bar integration
├── utils/
│   ├── logger.ts        # Logging utilities
│   └── dateUtils.ts     # Date formatting helpers
└── types/
    └── index.ts         # TypeScript type definitions

📋 TODO

Upcoming Features

• 📦 Event Caching - Cache usage events to a local table for offline access and improved performance
• 📈 Enhanced Analytics - Support more detailed analytics on usage events including:
  • Usage patterns and trends over time
  • Code completion acceptance rates
  • Peak usage hours analysis
  • Cost per feature breakdown
  • Weekly/monthly usage reports
• 👥 Team Support - Multi-user and team usage monitoring capabilities:
  • Team quota aggregation and tracking

🔗 Related Projects

If you're looking for alternatives or additional functionality, you might also be interested in:

cursor-stats - A comprehensive VS Code extension for Cursor subscription monitoring with advanced features like team usage tracking, multi-currency support, spending alerts, and extensive customization options. While Cursor Pulse focuses on elegant simplicity and performance, cursor-stats offers more detailed financial tracking and team-oriented features.

Thank you to the cursor-stats project for inspiring innovation in the Cursor monitoring space and providing users with excellent alternatives to choose from! 🙏

🙏 Acknowledgments

• Cursor Team - For building an amazing AI-powered code editor
• VS Code Team - For the excellent extension APIs
• Contributors - Thank you for your improvements and bug reports

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.