CodeFit - Developer Health & Wellness 💚

Stay healthy while coding. Smart health reminders and exercise tracking designed specifically for developers.

CodeFit is your personal health companion in VS Code. It intelligently reminds you to take breaks, guides you through quick exercises, and tracks your wellness journey—all without interrupting your flow.

🌐 Visit CodeFit.ai | 📖 Documentation | 🐛 Report Issues

✨ Features

🧠 Smart Health Reminders

Intelligent Timing: Learns your coding patterns and suggests breaks at natural pause points
Activity-Based: Triggers reminders after Git commits or extended coding sessions
Do Not Disturb: Respects your focus time and meeting schedules

🏃 Guided Exercise Library

10+ Exercises: Curated collection including stretches, eye care, breathing exercises, and movement breaks
Step-by-Step Guidance: Clear instructions with countdown timers for each exercise
Quick & Effective: Exercises designed to fit into 1-5 minute breaks

📊 Health Dashboard

Real-Time Tracking: Monitor your health score, streak, and daily activity
Visual Insights: Beautiful dashboard with progress charts and metrics
Data Export: Export your health data for personal records

🎮 Gamification System

XP & Levels: Earn experience points and level up as you maintain healthy habits
Achievements: Unlock achievements for milestones and consistent practice
Daily Quests: Complete daily health goals for bonus rewards
Streak Tracking: Build and maintain your wellness streak

🔧 Git Integration

Post-Commit Reminders: Gentle nudges to take a break after completing work
Activity Detection: Tracks coding intensity to optimize break timing

📍 Status Bar Integration

At-a-Glance Metrics: See your health score, level, and streak in the status bar
Color-Coded Indicators: Visual feedback on your current health status
One-Click Access: Click to open your dashboard instantly

🚀 Getting Started

Installation

Open VS Code
Press Ctrl+P (or Cmd+P on Mac)
Type: ext install codefit.codefit
Press Enter

Or install from the VS Code Marketplace

First Launch

When you first install CodeFit, you'll be greeted with a welcome message offering a quick tour. Choose:

Take Tour: Walk through CodeFit's features
Start Using: Jump right in
Visit Website: Learn more at CodeFit.ai

📖 Usage

Quick Actions

Command	Shortcut (Mac)	Shortcut (Win/Linux)	Description
Start Exercise	`Cmd+Alt+E`	`Ctrl+Alt+E`	Begin a guided exercise session
Open Dashboard	`Cmd+Alt+D`	`Ctrl+Alt+D`	View your health dashboard
Take Break Now	—	—	Trigger an immediate break reminder
Snooze Reminders	—	—	Pause reminders for 30 minutes
Pause/Resume	—	—	Toggle reminders on/off

Command Palette

Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Win/Linux) and search for:

CodeFit: Open Dashboard
CodeFit: Start Exercise
CodeFit: Take Break Now
CodeFit: Snooze Reminders
CodeFit: View Statistics
CodeFit: Pause/Resume Reminders
CodeFit: View Achievements
CodeFit: View Daily Quest
CodeFit: Export Data

⚙️ Configuration

Customize CodeFit to match your workflow. Access settings via Code > Preferences > Settings and search for "CodeFit".

Reminder Settings

{
  "codefit.reminder.frequency": "smart",  // Options: "smart", "30min", "60min", "90min"
  "codefit.reminder.style": "toast",      // Options: "toast", "statusBar", "background"
  "codefit.reminder.sound": false,        // Enable sound notifications
  "codefit.workMode": "freeform",         // Options: "pomodoro", "freeform", "deepWork"
}

Do Not Disturb

{
  "codefit.doNotDisturb.enabled": true,
  "codefit.doNotDisturb.hours": ["12:00-13:00", "15:00-16:00"]  // Time ranges
}

Exercise Preferences

{
  "codefit.exercise.intensity": "medium",  // Options: "light", "medium", "high"
  "codefit.exercise.types": ["stretch", "cardio", "breathing"],
  "codefit.exercise.duration": 3  // Minutes: 1, 3, or 5
}

Gamification

{
  "codefit.gamification.enabled": true,
  "codefit.gamification.showLevel": true,
  "codefit.gamification.dailyQuests": true
}

Display Options

{
  "codefit.display.statusBar": true,
  "codefit.display.theme": "auto"  // Options: "auto", "light", "dark"
}

Git Integration

{
  "codefit.git.integration": true,
  "codefit.git.commitReminder": true
}

🎯 Exercise Categories

Stretching (4 exercises)

Neck Stretch: Release tension from looking at screens
Shoulder Rolls: Reduce upper body stiffness
Wrist Stretch: Prevent repetitive strain injuries
Standing Side Stretch: Full body stretch

Eye Care (2 exercises)

20-20-20 Rule: Look 20 feet away for 20 seconds every 20 minutes
Eye Circles: Reduce eye strain and improve focus

Breathing (2 exercises)

Deep Breathing: Calm your mind and reduce stress
Box Breathing: Improve focus and mental clarity

Movement (2 exercises)

Desk Push-ups: Quick strength exercise
Calf Raises: Improve circulation

📈 Health Metrics Explained

Health Score (0-100)

Your overall wellness score based on:

Break frequency (40% weight)
Exercise duration (30% weight)
Consistency (20% weight)
Coding time balance (10% weight)

Streak

Consecutive days of meeting your recommended break goals. Build your streak to unlock achievements!

XP & Levels

XP: Earned by completing exercises and maintaining healthy habits
Levels: Progress through 9 levels from "Newbie" to "Health Master"

🏆 Achievements

Unlock achievements by:

Completing your first exercise
Maintaining 7-day, 30-day, and 100-day streaks
Reaching level milestones
Taking all recommended breaks in a day
Trying different exercise types

🎨 Status Bar Icons

Icon	Meaning
❤️	Your current health score
🔥	Your active streak (days)
✓	Breaks taken today
⭐	Your current level

Color Coding:

🟢 Green (80-100): Excellent health habits
🟡 Yellow (60-79): Room for improvement
🔴 Red (0-59): Need more breaks

🔒 Privacy

CodeFit stores all data locally in your VS Code workspace. We never collect or transmit your health data.

Data Storage

Health statistics: Local VS Code storage
Activity history: Local workspace storage
No cloud sync: Your data stays on your machine

Analytics Options

{
  "codefit.privacy.analytics": "none"  // Options: "full", "anonymous", "none"
}

💡 Tips for Success

Start Small: Begin with just one exercise per break
Be Consistent: Build a daily habit rather than sporadic intense activity
Customize: Adjust reminder frequency to match your workflow
Use Shortcuts: Learn the keyboard shortcuts for quick access
Track Progress: Check your dashboard regularly to stay motivated

🤝 Contributing

We welcome contributions! Here's how you can help:

Report Bugs: GitHub Issues
Submit PRs: Fork the repo and submit pull requests
Share Feedback: Visit CodeFit.ai to learn more

📜 License

MIT License - see LICENSE for details

🙏 Acknowledgments

Built with ❤️ for developers who care about their health.

Special thanks to the VS Code team and the open-source community.

🔗 Links

Website: www.codefit.ai
GitHub: github.com/aplomb2/CodeFit
Issues: github.com/aplomb2/CodeFit/issues

Stay healthy. Code better. 💚

Get Started · Report Bug · Request Feature