Skip to content

GoldenTangerine/cursor-stats

 
 

Repository files navigation

Cursor Stats

A powerful Cursor extension that provides real-time monitoring of your Cursor subscription usage,

including fast requests and usage-based pricing information.

VS Code Marketplace Downloads Rating

✨ Features

Core Features

  • 🚀 Real-time usage monitoring
  • 👥 Team usage tracking
  • 📊 Premium request analytics
  • 💰 Usage-based pricing insights
  • 🔄 Smart cooldown system
  • 🔔 Intelligent notifications
  • 💸 Spending alerts
  • 💳 Mid-month payment tracking

Advanced Features

  • 🎨 Customizable status bar
  • 📈 Progress bar visualization
  • 🌍 Multi-currency support
  • 📝 Diagnostic reporting
  • ⚡ Command palette integration
  • 🌙 Cursor Nightly version support
  • 🔄 GitHub release updates
  • 🔒 Secure token management

🔜 Upcoming Features

  • 📊 Session-based request tracking
  • 📈 Visual analytics dashboard
  • 🎯 Project-specific monitoring
  • 🎨 Enhanced statistics view
  • ⚙️ Advanced customization options

📸 Screenshots

Default UI Custom Currency
Progress Bars Settings

⚙️ Configuration

Setting Description Default
cursorStats.enableLogging Enable detailed logging true
cursorStats.enableStatusBarColors Toggle colored status bar true
cursorStats.statusBarColorThresholds Customize status bar text color based on usage percentage Array of 14 color thresholds
cursorStats.enableAlerts Enable usage alerts true
cursorStats.usageAlertThresholds Percentage thresholds for usage alerts [10, 30, 50, 75, 90, 100]
cursorStats.showTotalRequests Show sum of all requests instead of only fast requests false
cursorStats.refreshInterval Update frequency (seconds) 60
cursorStats.spendingAlertThreshold Spending alert threshold (in your selected currency) 1
cursorStats.currency Custom currency conversion USD
cursorStats.showProgressBars Enable progress visualization false
cursorStats.progressBarLength Progress bar length (for progress visualization) 10
cursorStats.progressBarWarningThreshold Percentage threshold for progress bar warning (yellow) 50
cursorStats.progressBarCriticalThreshold Percentage threshold for progress bar critical (red) 75
cursorStats.customDatabasePath Custom path to Cursor database ""
cursorStats.excludeWeekends Exclude weekends from period progress and daily calculations false
cursorStats.showDailyRemaining Show estimated fast requests remaining per day false
cursorStats.language Language for extension interface and messages en
cursorStats.showChangelogOnUpdate Show changelog popup and update notifications when extension updates true

🔧 Commands

Command Description
cursor-stats.refreshStats Manually refresh statistics
cursor-stats.openSettings Open extension settings
cursor-stats.setLimit Configure usage-based pricing settings
cursor-stats.selectCurrency Change display currency
cursor-stats.selectLanguage Select language for extension interface
cursor-stats.createReport Generate diagnostic report

🚀 Installation

VS Code Marketplace

  1. Open VS Code
  2. Press Ctrl+P / ⌘P
  3. Run ext install Dwtexe.cursor-stats

Or install directly from VS Code Marketplace

Manual Installation

  1. Download the latest .vsix from Releases
  2. Open Cursor
  3. Press Ctrl+Shift+P / ⌘⇧P
  4. Run Install from VSIX
  5. Select the downloaded file

🤝 Contributing

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

📦 开发与打包 (Development & Packaging)

环境准备

确保你已安装以下工具:

  • Node.js (>= 16)
  • npm
  • Visual Studio Code Extension CLI (@vscode/vsce)

安装依赖

# 安装项目依赖
npm install

# 全局安装 vsce 工具(如果尚未安装)
npm install -g @vscode/vsce

开发命令

# 编译 TypeScript 代码
npm run compile

# 监听文件变化并自动编译
npm run watch

# 代码格式化
npm run format

# 代码检查
npm run lint

# 运行测试
npm run test

打包发布

# 编译项目(必须在打包前执行)
npm run compile

# 打包为 .vsix 文件
vsce package

# 打包指定版本
vsce package --out builds/cursor-stats-1.1.7.vsix

# 发布到市场(需要配置 publisher token)
vsce publish

注意事项

  1. 打包前必须编译:确保运行 npm run compile 编译 TypeScript 代码
  2. 版本号检查:确认 package.json 中的版本号正确
  3. 构建目录.vsix 文件默认生成在 builds/ 目录
  4. 本地化文件:编译过程会自动复制 src/locales/out/locales/

文件结构

cursor-stats/
├── src/                # TypeScript 源码
│   ├── extension.ts    # 扩展入口
│   ├── handlers/       # 处理程序
│   ├── services/       # 服务层
│   ├── utils/          # 工具函数
│   └── locales/        # 多语言文件
├── out/                # 编译输出
├── builds/             # 打包文件
└── package.json        # 项目配置

💬 Support

💝 Donations

If you find this extension helpful, consider supporting its development:

Click to view donation options

Buy Me A Coffee

Buy Me A Coffee

Binance

  • ID: 39070620

USDT

  • Multi-Chain (BEP20/ERC20/Arbitrum One/Optimism):

    0x88bfb527158387f8f74c5a96a0468615d06f3899
    
  • TRC20:

    TPTnapCanmrsfcMVAyn4YiC6dLP8Wx1Czb
    

📄 License

MIT © Dwtexe


Made with ❤️ by Dwtexe

About

Self-use AI modified version

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 99.7%
  • JavaScript 0.3%