CursorFit 🏃‍♂️💻

🤖 Built for the AI Coding Era

Ever notice how you feel after a 6-hour coding session with Cursor, GitHub Copilot, or Claude? Your neck hurts, your eyes are dry, and you haven't moved in hours.

CursorFit intelligently monitors your AI usage patterns and reminds you to take care of your body when you need it most.

✨ What Makes CursorFit Special?

🧠 AI-Aware: Detects when you're using Cursor, Copilot, or other AI tools and adjusts recommendations accordingly
⏰ Smart Timing: No annoying popups every 5 minutes - reminders are contextually aware
🎯 Minimal Interference: Designed to enhance your flow state, not break it
🔒 Privacy First: Your code never leaves your machine - we only track usage patterns

How It Works

• Real-time AI Detection: Monitors your coding patterns to identify AI-assisted sessions
• Intelligent Reminders: Suggests breaks based on AI usage intensity and session duration
• Health Analytics: Track your coding health over time with optional web dashboard sync

🚀 Quick Start

# Install from VS Code Marketplace
code --install-extension CursorFit.cursorfit-ai

That's it! CursorFit works immediately:

1. Install → Extension activates automatically
2. Code normally → CursorFit learns your patterns
3. Get smart reminders → Gentle suggestions when you need them
4. Take micro-breaks → 30-second exercises keep you healthy
5. Stay productive → Return to coding refreshed

💡 No setup required - Works out of the box with intelligent defaults

📊 What You'll See

🏃‍♂️ Exercise Library

5 scientifically-backed micro-exercises designed for developers:

⚡ Commands & Shortcuts

Command Palette (Ctrl+Shift+P)

CursorFit: Quick Exercise        → Start an exercise right now
CursorFit: Show Daily Stats      → See today's health metrics  
CursorFit: Open Dashboard        → View web analytics (optional)
CursorFit: Connect to Web App    → Sync across devices

Keyboard Shortcuts

⚙️ Configuration

Access via Preferences → Settings → Extensions → CursorFit:

{
  "cursorfit.reminderInterval": 30,           // Minutes between reminders
  "cursorfit.enableSmartReminders": true,    // AI-powered timing
  "cursorfit.enabled": true                   // Master toggle
}

🧠 Smart Reminder Algorithm

CursorFit uses contextual awareness to suggest breaks at optimal times:

✅ Triggers Reminders When:

• 🕒 30+ minutes of continuous coding
• 🤖 High AI usage detected (lots of Copilot/Cursor requests)
• 📊 Health score declining (below 70/100)
• ⏱️ Extended session on same project

🚫 Respects Your Flow:

• 🎯 Just completed exercise (30min cooldown)
• 🔥 Active typing/AI generation (waits for natural pause)
• ⏸️ Manual disable via settings
• 💤 Idle detection (no interruptions during breaks)

📈 Web Dashboard (Optional)

Unlock deeper insights with the CursorFit Analytics Dashboard:

# Connect in 30 seconds
1. Run: "CursorFit: Connect to Web App"
2. Authenticate via browser  
3. View cross-device analytics

Dashboard Features:

• 📊 Weekly/monthly health trends
• 🤖 AI usage patterns and productivity correlation
• 🏆 Exercise streaks and achievements
• 📱 Multi-device sync (VS Code + other editors)

🔒 Privacy & Security

Your code stays on your machine. Period.

✅ We Track:              ❌ We DON'T Track:
• AI request frequency    • Code content  
• Session duration        • Keystrokes
• Project name only       • File names
• Exercise completion     • Personal data

Data Handling:

• 🏠 Local-first: All data stored locally by default
• 🔗 Optional sync: Web dashboard requires explicit opt-in
• 🗑️ Easy cleanup: Uninstall removes all data
• 📖 Open source: Audit our code anytime

🛠️ For Developers

Installation Methods

# VS Code Marketplace (Recommended)
code --install-extension CursorFit.cursorfit-ai

# Alternative: Search "CursorFit AI" in VS Code Extensions panel

📞 Support & Community

Visit cursorfit.app for:

• 🐛 Bug reports and feature requests
• 📧 Contact and support
• 📖 Documentation and guides
• 🌐 Web dashboard and analytics

License: MIT | Maintained by: CursorFit Team