{"id":30204455,"url":"https://github.com/lroolle/cursor-pulse","last_synced_at":"2025-08-13T12:46:41.365Z","repository":{"id":297980233,"uuid":"998462669","full_name":"lroolle/cursor-pulse","owner":"lroolle","description":"An Elegant @Cursor_AI extension for monitoring usage events and analytics.","archived":false,"fork":false,"pushed_at":"2025-06-19T17:07:33.000Z","size":832,"stargazers_count":6,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-02T18:21:10.725Z","etag":null,"topics":["agent","cursorai","vibe-coding"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=lroolle.cursor-pulse","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lroolle.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-08T16:57:21.000Z","updated_at":"2025-07-27T14:27:07.000Z","dependencies_parsed_at":"2025-06-08T18:44:18.179Z","dependency_job_id":null,"html_url":"https://github.com/lroolle/cursor-pulse","commit_stats":null,"previous_names":["lroolle/cursor-pulse"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/lroolle/cursor-pulse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lroolle%2Fcursor-pulse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lroolle%2Fcursor-pulse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lroolle%2Fcursor-pulse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lroolle%2Fcursor-pulse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lroolle","download_url":"https://codeload.github.com/lroolle/cursor-pulse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lroolle%2Fcursor-pulse/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270244530,"owners_count":24551629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","cursorai","vibe-coding"],"created_at":"2025-08-13T12:46:37.163Z","updated_at":"2025-08-13T12:46:39.967Z","avatar_url":"https://github.com/lroolle.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor Pulse\n\n**Elegant monitoring for Cursor AI subscription quota with clean status bar integration and rich\nanalytics**\n\n[![Version](https://img.shields.io/badge/version-1.0.4-blue)](https://github.com/lroolle/cursor-pulse)\n[![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)\n[![Cursor](https://img.shields.io/badge/Cursor-1.0.0+-blue)](https://cursor.com/)\n[![Marketplace](https://img.shields.io/badge/VS%20Code-Marketplace-blue)](https://marketplace.visualstudio.com/items?itemName=lroolle.cursor-pulse)\n\n![Screenshot](https://raw.githubusercontent.com/lroolle/cursor-pulse/main/images/cursor-pulse-screenshot.png)\n\n## 🎉 New in v1.0.0 - Full New Pricing Model Support\n\n**✨ Complete Support for Cursor's Updated Pricing Tiers**:\n\n- **⭐ Pro/Team/Ultra Smart Limits**: Native \"unlimited usage with smart rate-limits\" detection and\n  monitoring\n- **🔄 Hybrid Detection**: Automatic switching between quota and rate-limiting monitoring modes\n- **🔧 Legacy Compatibility**: Continued support for traditional 500-request quota models\n\n## ✨ Features\n\n- **🔄 Real-time Monitoring** - Track Cursor usage limits, rate-limits, and spending in your status\n  bar\n- **📊 Rich Analytics** - View usage statistics, lines edited, and recent activity across all plan\n  types\n- **⚡ Smart Caching** - Fast loading with intelligent data refresh and offline access\n- **🎨 Visual Feedback** - Smooth animations and status indicators with rate-limiting alerts\n- **🔍 Detailed Tooltips** - Hover for comprehensive usage information and plan-specific metrics\n- **🛡️ Privacy-First** - Read-only local access, no third-party data collection\n- **🚀 Multi-Plan Support** - Automatic detection of Ultra, Pro, Team, and legacy pricing models\n- **📈 Advanced Analytics** - Detailed usage pattern analysis and cost tracking\n\n## 🚀 Installation\n\n### Marketplace (Recommended)\n\n**[📦 Marketplace Link](https://marketplace.visualstudio.com/items?itemName=lroolle.cursor-pulse)**\n\n1. Within Cursor, Open Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`)\n2. Search \"Cursor Pulse\" → Install\n\n### GitHub Releases\n\n**[📥 Download VSIX](https://github.com/lroolle/cursor-pulse/releases)**\n\n1. Download latest `.vsix` from releases\n2. `Ctrl+Shift+P` → `Extensions: Install from VSIX...`\n3. Select downloaded file\n\n## 💡 Usage\n\n### Commands \u0026 Tooltips\n\n**Available Commands** (`Ctrl+Shift+P` or just click the status bar):\n\n- `Cursor Pulse: Soft/Hard Reload` - Refresh data (with/without cache)\n- `Cursor Pulse: Open Settings` - Configure preferences\n- `Cursor Pulse: Show Logs` - View debug output\n- `Cursor Pulse: Toggle Rate-Limit Mode` - Switch between quota and rate-limit monitoring\n\n**Tooltip Information**: Hover the status bar for account details, analytics, recent activity,\nquota/rate-limit information, and plan-specific metrics.\n\n## ⚙️ Configuration\n\n**Key Settings**:\n\n- `cursorPulse.refreshInterval` - Auto-refresh interval (default: 120s, min: 60s)\n- `cursorPulse.showPercentage` - Show percentage in status bar (default: true)\n- `cursorPulse.analyticsTimePeriod` - Analytics window: `1d`, `7d`, `30d` (default: 7d)\n- `cursorPulse.enableQuotaAnimation` - Visual animations (default: true)\n- `cursorPulse.rateLimitNotifications` - Enable rate-limit status notifications (default: true)\n- `cursorPulse.planDetectionMode` - Plan detection: `auto`, `quota`, `rate-limit` (default: auto)\n\n**Access Settings**: Command Palette → `Cursor Pulse: Open Settings`\n\n## 🔧 Requirements\n\nCursor ≥1.0.0, internet connection.\n\n## 🛠️ Troubleshooting\n\n**Common Issues**:\n\n- Extension not loading → Check Output panel → \"Cursor Pulse\"\n- Authentication errors → Restart Cursor to refresh tokens\n- Status bar not updating → Try \"Hard Reload\" command\n- Plan detection issues → Use \"Toggle Rate-Limit Mode\" or check settings\n\n**Debug Mode**: `Cursor Pulse: Set Log Level` → Debug → `Show Logs`\n\n## 🔒 Privacy\n\n- ✅ **Local access only** - Reads Cursor database safely (read-only)\n- ✅ **No third-party services** - Direct Cursor API communication only\n- ✅ **No data collection** - Zero telemetry or external data sharing\n\n## 🤝 Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**Quick Start**: `git clone` → `npm install` → `npm run watch` → Press F5 in VS Code\n\n## 📋 Roadmap\n\n### v1.1.0 - Advanced Analytics \u0026 Caching\n\n- **📦 Event Caching** - Cache usage events to a local table for offline access and improved\n  performance\n- **📈 Advanced Analytics Dashboard** - Detailed usage pattern analysis including:\n  - Usage trends and peak hours analysis\n  - Code completion acceptance rates\n  - Cost per feature breakdown\n  - Weekly/monthly usage reports with export options\n\n### Future Considerations\n\n- **🔔 Smart Notifications** - Proactive alerts for usage optimization\n\n## 🔗 Related Projects\n\n**[cursor-stats](https://github.com/Dwtexe/cursor-stats)** - Alternative with team usage tracking\nand advanced financial monitoring features.\n\n## 🙏 Acknowledgments\n\nThanks to Cursor Team, VS Code Team, and all contributors! 🙏\n\n## 📄 License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**📊 Monitor your Cursor usage with style! ⚡**\n\n[📦 Install from Marketplace](https://marketplace.visualstudio.com/items?itemName=lroolle.cursor-pulse)\n• [Report Bug](https://github.com/lroolle/cursor-pulse/issues) •\n[Request Feature](https://github.com/lroolle/cursor-pulse/issues) •\n[Discussions](https://github.com/lroolle/cursor-pulse/discussions)\n\n\u003c/div\u003e\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flroolle%2Fcursor-pulse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flroolle%2Fcursor-pulse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flroolle%2Fcursor-pulse/lists"}