CursorFit - Developer Health & Wellness Extension

CursorFit is a smart VS Code extension designed to help developers maintain their health and wellness while using AI coding assistants. It intelligently tracks your AI usage patterns and provides personalized exercise reminders to keep you healthy and productive.

✨ Features

🤖 Smart AI Detection

Automatically detects when you're using AI coding assistants
Tracks AI request patterns across different projects
Monitors coding intensity and session duration

🏥 Health Score System

Real-time health scoring based on AI usage vs. exercise balance
Personalized recommendations for optimal coding wellness
Visual health indicators in the status bar

💪 Intelligent Exercise Reminders

Smart exercise suggestions based on your coding patterns
Variety-driven recommendations (5 different exercise types)
Context-aware timing (considers session length, time of day, etc.)

📊 Project-Based Analytics

Per-project health tracking
Daily statistics and progress monitoring
Coding time vs. wellness balance insights

🔗 Web App Integration

Sync your data with the CursorFit web dashboard
Cross-device health tracking
Advanced analytics and insights

🚀 Getting Started

Install the Extension
- Install CursorFit from the VS Code Marketplace
- The extension will automatically activate when you start coding
Configure Your Settings
- Open VS Code settings (Ctrl+, or Cmd+,)
- Search for "CursorFit"
- Customize your preferences
Connect to Web App (Optional)
- Run CursorFit: Connect to Web App from the command palette
- Follow the authentication flow to sync your data
- Your extension will be securely linked to your CursorFit account

🎯 How It Works

CursorFit intelligently monitors your coding patterns and provides health reminders at optimal times:

AI Usage Detection: Automatically identifies when you're using AI assistants
Smart Timing: Suggests breaks based on session length, AI usage frequency, and time patterns
Exercise Variety: Rotates between different exercise types to prevent repetition
Health Scoring: Calculates your wellness score based on the balance between AI usage and exercise

📈 Exercise Types

👁️ Eye Relief - Reduce eye strain from screen time
🦴 Neck & Shoulders - Combat tech neck and shoulder tension
🏃 Posture Check - Improve sitting posture and spinal alignment
✋ Wrist & Hands - Prevent repetitive strain injuries
🚶 Get Moving - Full body movement and circulation

⚙️ Configuration

{
  "cursorfit.enabled": true,
  "cursorfit.webAppUrl": "http://localhost:3000",
  "cursorfit.reminderInterval": 30,
  "cursorfit.enableSmartReminders": true,
  "cursorfit.authToken": "",
  "cursorfit.deviceId": "",
  "cursorfit.hasRunBefore": false
}

📱 Commands

CursorFit: Show Daily Stats - View your daily health statistics
CursorFit: Quick Exercise - Start a recommended exercise session
CursorFit: Open Dashboard - Open the web dashboard
CursorFit: Connect to Web App - Authenticate with the web service
CursorFit: Enable/Disable - Toggle the extension on/off

🔒 Privacy & Data

CursorFit respects your privacy:

No code content is ever transmitted or stored
Only usage patterns and timing data are tracked
Web sync is optional and can be disabled at any time
All data is encrypted in transit and at rest

🛠️ Development

This extension is built with:

JavaScript/Node.js
VS Code Extension API
Axios for web integration
Smart pattern recognition algorithms

Local Development

Clone the repository

git clone https://github.com/cursorfit/cursorfit-extension.git
cd cursorfit-extension

Install dependencies
```
npm install
```
Open in VS Code
```
code .
```
Press F5 to start debugging

Configuration

For local development, you can set the web app URL to your local NextJS server:

{
  "cursorfit.webAppUrl": "http://localhost:3000"
}

📝 License

MIT License - see LICENSE file for details

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📞 Support

🐛 Report bugs on GitHub Issues
💬 Join our community discussions on Discord
📧 Contact us at support@cursorfit.app

Stay healthy, code better! 💪🚀

CursorFit