CodeFit - Developer Health & Wellness 💚

undefinedStay 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 Issuesundefined

---

✨ Features

🧠 Smart Health Reminders

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

🏃 Guided Exercise Library

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

📊 Health Dashboard

• undefinedReal-Time Tracking: Monitor your health score, streak, and daily activity
• undefinedVisual Insights: Beautiful dashboard with progress charts and metrics
• undefinedData Export: Export your health data for personal records

🎮 Gamification System

• undefinedXP & Levels: Earn experience points and level up as you maintain healthy habits
• undefinedAchievements: Unlock achievements for milestones and consistent practice
• undefinedDaily Quests: Complete daily health goals for bonus rewards
• undefinedStreak Tracking: Build and maintain your wellness streak

🔧 Git Integration

• undefinedPost-Commit Reminders: Gentle nudges to take a break after completing work
• undefinedActivity Detection: Tracks coding intensity to optimize break timing

📍 Status Bar Integration

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

---

🚀 Getting Started

Installation

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

undefinedOr 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:

• undefinedTake Tour: Walk through CodeFit’s features
• undefinedStart Using: Jump right in
• undefinedVisit Website: Learn more at CodeFit.ai

---

📖 Usage

Quick Actions

Command	Shortcut (Mac)	Shortcut (Win/Linux)	Description
undefinedStart Exerciseundefined	Cmd+Alt+E	Ctrl+Alt+E	Begin a guided exercise session
undefinedOpen Dashboardundefined	Cmd+Alt+D	Ctrl+Alt+D	View your health dashboard
undefinedTake Break Nowundefined	—	—	Trigger an immediate break reminder
undefinedSnooze Remindersundefined	—	—	Pause reminders for 30 minutes
undefinedPause/Resumeundefined	—	—	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)

• undefinedNeck Stretch: Release tension from looking at screens
• undefinedShoulder Rolls: Reduce upper body stiffness
• undefinedWrist Stretch: Prevent repetitive strain injuries
• undefinedStanding Side Stretch: Full body stretch

Eye Care (2 exercises)

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

Breathing (2 exercises)

• undefinedDeep Breathing: Calm your mind and reduce stress
• undefinedBox Breathing: Improve focus and mental clarity

Movement (2 exercises)

• undefinedDesk Push-ups: Quick strength exercise
• undefinedCalf 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

• undefinedXP: Earned by completing exercises and maintaining healthy habits
• undefinedLevels: 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

undefinedColor Coding:undefined

• 🟢 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

1. undefinedStart Small: Begin with just one exercise per break
2. undefinedBe Consistent: Build a daily habit rather than sporadic intense activity
3. undefinedCustomize: Adjust reminder frequency to match your workflow
4. undefinedUse Shortcuts: Learn the keyboard shortcuts for quick access
5. undefinedTrack Progress: Check your dashboard regularly to stay motivated

---

🤝 Contributing

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

• undefinedReport Bugs: GitHub Issues
• undefinedSubmit PRs: Fork the repo and submit pull requests
• undefinedShare 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

• undefinedWebsite: www.codefit.ai
• undefinedGitHub: github.com/aplomb2/CodeFit-Extension
• undefinedIssues: github.com/aplomb2/CodeFit-Extension/issues

---