Break Bully - AI-Powered Wellness Extension for VS Code
Your intelligent wellness companion that helps developers maintain healthy work habits through smart break reminders, exercise guidance, and revolutionary AI productivity intelligence.
Break Bully has evolved from a simple reminder system into a comprehensive wellness platform with groundbreaking AI capabilities that actively monitor your activity patterns, provide personalized productivity insights, and intelligently optimize your work habits. Our new Machine Learning Activity Monitor analyzes your coding behavior to deliver unprecedented productivity intelligence! 💪🤖
✨ Key Features
🔔 Intelligent Break Reminders
- 4 Annoyance Levels: From gentle reminders to persistent nagging
- Smart Timing: Adapts based on your work patterns and activity
- Multiple Personalities: Choose from gentle, motivational, funny, mindful, or annoying styles
- Work-Rest Models: Pomodoro, WHO guidelines, and custom timing
👁️ Eye Health & Screen Management
- Screen Time Tracking: Monitor continuous screen usage
- Eye Exercise Library: 20-20-20 rule and specialized exercises
- Automatic Break Suggestions: Smart eye break recommendations
- Activity Monitoring: Real-time tracking of coding sessions
🏆 Achievement System
- Progress Tracking: Unlock badges and achievements
- Goal Setting: Daily and weekly wellness objectives
- Streak Rewards: Build healthy habits with streak tracking
- Statistics Dashboard: Comprehensive wellness analytics
🏃♂️ Exercise Library
- Built-in Exercises: Stretches, breathing, and eye exercises
- Custom Exercises: Create and save your own routines
- Guided Workflows: Step-by-step exercise instructions
- Completion Tracking: Monitor your exercise habits
🔗 Git Integration
- Productivity Tracking: Monitor commit patterns
- Smart Break Suggestions: Break recommendations based on activity
- Workflow Integration: Seamless integration with development workflow
🤖 AI Activity Monitor - Revolutionary Productivity Intelligence
- Machine Learning Engine: Advanced AI that analyzes your coding behavior patterns
- Peak Performance Discovery: Identifies your optimal productive hours using 24-hour analysis
- Burnout Prevention: Early detection and intervention for fatigue patterns
- Productivity Forecasting: Predicts performance with confidence scores for different times
- Smart Break Optimization: Learns your optimal work-rest cycle (e.g., "45:10" ratio)
- Comprehensive Activity Tracking: Monitors 15+ development activities (Git commits, debugging, testing, refactoring, search operations)
- Real-time State Detection: Intelligent coding state recognition (Reading/Coding/Debugging/Searching/Idle)
- Personal Analytics Export: JSON/CSV data export for offline analysis with privacy controls
- Context-Aware Intelligence: Adapts behavior based on file types and activity patterns
- Flow State Celebration: Detects and celebrates when you enter "the zone"
🧘 Wellness ML - Personal Stretch, Breathing, Eye & Water Intelligence
- Individual Activity Analysis: ML learns optimal timing for stretching, breathing, eye exercises, and water breaks
- Exercise Success Prediction: Predicts completion likelihood and suggests alternative times
- Personalized Daily Routines: AI creates custom morning/afternoon/evening wellness schedules
- Smart Water Scheduling: Intelligent hydration reminders based on activity patterns and dehydration risk
- Stress-Aware Recommendations: Different suggestions for low/medium/high stress levels
- Advanced Notification Learning: System learns from your responses to optimize future messaging
- Notification Performance Analytics: Tracks acceptance rates and optimizes notification strategies
- Contextual Wellness Suggestions: Time-of-day appropriate exercise recommendations
💍 Marriage Support Campaign - Love Story & Donation System
- "Support Marriage" Button: Beautiful donation integration in Quick Actions (💘 icon)
- Heartfelt Love Story: Personal message about wanting to marry the love of my life 💒
- Multiple Donation Platforms:
- PayPal (paypal.me/freerave1) - Direct financial support
- Buy Me a Coffee (buymeacoffee.com/freerave) - Developer appreciation donations
- Ko-fi (ko-fi.com/freerave) - Flexible support platform
- GitHub Sponsors (github.com/sponsors/kareem2099) - Recurring developer support
- Beautiful Modal Design: Love-themed interface with floating hearts (💕💖💗💘💞💓)
- Personal Impact: Every donation helps build our future together 💍
- Non-Intrusive Presentation: Touching story without being pushy
⏰ Real-Time Precision Timer
- Second-by-Second Updates: Timer refreshes every 1 second for exact remaining time
- Live Countdown Display: Users see precise timing (4:30 → 4:29 → 4:28 → ...)
- Professional Experience: Matches expectations of modern timer applications
- Reduced User Anxiety: Crystal clear timing prevents timing uncertainty
- Enhanced Productivity Focus: Precise break timing for better work-life balance
📱 Installation
From VSCode Marketplace
- Open VSCode
- Go to Extensions (Ctrl+Shift+X)
- Search for "Break Bully"
- Click Install
From Source
git clone https://github.com/kareem2099/break-bully.git
cd break-bully
npm install
npm run compile
🎮 Complete Command Reference
Core Commands
Break Bully: Show Reminder - Get an immediate break reminderBreak Bully: Toggle Reminders - Enable/disable break remindersBreak Bully: Open Settings - Access extension configurationBreak Bully: Take a Break - Start a break session immediately
Exercise Commands
Break Bully: Quick Stretch - Launch a quick stretching exerciseBreak Bully: Eye Exercise - Start an eye health exerciseBreak Bully: Breathing Exercise - Begin a breathing exercise
Advanced Features
Break Bully: Change Workout Model - Switch between work-rest timing modelsBreak Bully: Force Unblock Screen - Emergency screen unblock (admin feature)Break Bully: Create Custom Exercise - Add a new custom exerciseBreak Bully: Show Custom Exercise Library - Browse your custom exercisesBreak Bully: Trigger Git Break Suggestion - Check productivity and suggest breaksBreak Bully: Show Update Panel - View latest features and updates
🤖 AI Activity Monitor Commands
Break Bully: Get Peak Performance Times - See your optimal productive hours based on AI analysisBreak Bully: Check Burnout Risk - Get AI assessment of current fatigue levelsBreak Bully: Predict Productivity - Forecast performance for different times/activitiesBreak Bully: Get Work Pattern Insights - View AI-recommended work-rest optimizationBreak Bully: Export Activity Data - Download your productivity data as JSON/CSVBreak Bully: Show AI Insights - Get comprehensive productivity profile and recommendations
🧘 Wellness ML Commands
Break Bully: Get Wellness Timing Insights - Discover optimal times for stretch/breathing/eye/water activitiesBreak Bully: Create Personal Wellness Routine - Generate AI-customized daily wellness scheduleBreak Bully: Predict Exercise Success - See completion likelihood for different wellness activitiesBreak Bully: Get Wellness Notification Analytics - View how well ML-optimized notifications performBreak Bully: Smart Stress Response - Get AI wellness recommendations based on current stress levels
⚙️ Configuration Options
Break Reminders
- Enabled: Toggle break reminders on/off
- Interval: Reminder frequency (5-180 minutes)
- Show Notification: Enable/disable popup notifications
- Play Sound: Audio notifications for reminders
- Reminder Type: Choose personality (gentle, motivational, funny, mindful, annoying)
- Annoyance Level: Escalation intensity (mild, moderate, extreme, nuclear)
- Persistent Nagging: Continuous reminders until break is taken
Eye Health
- Enable Eye Exercises: Toggle eye health features
- Screen Break Interval: Minutes before eye break suggestions
Goals & Achievements
- Enable Goals: Daily/weekly wellness objectives
- Enable Achievements: Badge and reward system
Work-Rest Models
- Work-Rest Model: Choose timing pattern:
pomodoro-classic: 25min work, 5min restwho-45min-work-15min-rest: WHO recommendedwho-1hour-work-30min-rest: Extended sessionswho-2hour-work-1hour-rest: Long work blockswho-90min-work-30min-rest: Research-basedcustom-flexible: Custom timing
Git Integration
- Enable Git Integration: Productivity tracking
- Commit Threshold: Commits before break suggestion
- Productivity Check Interval: Minutes between checks
Notifications
- Show Exercise Completion: Completion notifications
- Play Exercise Completion Sound: Audio feedback
🤖 AI Activity Monitor Settings
- Enable AI Monitoring: Toggle machine learning activity analysis on/off
- Privacy Controls: Manage data retention and export permissions
- Notification Preferences: Control AI insight and state change notifications
- Analysis Interval: Frequency of AI pattern analysis updates
- Data Retention Period: How long to keep activity data (7/30/90 days)
- Confidence Threshold: Minimum confidence level for AI recommendations
🏗️ Architecture
Modular Design
- Core Engine: Break timing and reminder logic
- UI System: Modern webview interface with VSCode theming
- Service Layer: Specialized services for different features
- Storage System: Persistent data management
- Analytics: Comprehensive usage tracking
File Structure
src/
├── extension.ts # Main extension entry point
├── types.ts # TypeScript type definitions
├── models/
│ └── state.ts # Global state management
├── services/ # Feature-specific services
│ ├── breakService.ts
│ ├── exerciseService.ts
│ ├── wellnessService.ts
│ ├── achievementService.ts
│ └── analyticsService.ts
├── services/activityIntegration/ # Complete AI Wellness Intelligence System
│ ├── machineLearningAnalyzer.ts # Core ML intelligence engine
│ ├── wellnessMLAnalyzer.ts # Wellness-specific ML (stretch/breath/eye/water)
│ ├── advancedNotificationManager.ts # ML-powered notification optimization
│ ├── baseActivityMonitor.ts # Enhanced activity monitoring with AI
│ ├── activityTypes.ts # Activity data type definitions
│ ├── activitySettings.ts # AI monitoring configuration
│ ├── advancedAnalytics.ts # Analytics processing service
│ └── smartScheduler.ts # Intelligent break scheduling
├── ui/ # User interface components
│ ├── activityBarProvider.ts
│ ├── changeWorkoutPanel.ts
│ └── updatePanel.ts
├── views/ # Webview HTML/CSS/JS
├── core/ # Core functionality
└── utils/ # Utility functions
🧪 Testing
npm test # Run all tests
npm run test:ci # CI environment testing
Test Coverage:
- ✅ Extension activation and registration
- ✅ Command execution and validation
- ✅ Configuration management
- ✅ UI component functionality
- ✅ Service layer operations
- ✅ Error handling and edge cases
📊 Wellness Insights
Break Bully provides comprehensive analytics:
- Break Patterns: Frequency and consistency tracking
- Screen Time: Daily usage monitoring
- Goal Completion: Progress toward wellness objectives
- Achievement Progress: Badge earning statistics
- Exercise Habits: Usage patterns and preferences
🔧 Development
Prerequisites
- Node.js 18+
- VSCode 1.60+
- TypeScript 4.9+
Setup
npm install # Install dependencies
npm run compile # Build the extension
npm run watch # Watch mode for development
Testing
npm test # Run test suite
npm run test:ci # CI testing
Publishing
npm run vscode:prepublish # Prepare for publishing
vsce package # Create .vsix package
vsce publish # Publish to marketplace
🤝 Contributing
We welcome contributions! Break Bully is open source and we appreciate help in making it better.
Ways to Contribute
- Bug Reports: Found an issue? Let us know!
- Feature Requests: Have ideas for new wellness features?
- Code Contributions: Help improve the codebase
- Documentation: Improve guides and documentation
- Testing: Add more test coverage
Development Process
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new features
- Submit a pull request
📄 License
MIT License - See LICENSE file for details.
🙏 Acknowledgments
- Built with VSCode Extension API
- Inspired by wellness research and developer health initiatives
- Thanks to the VSCode community for extension development resources
📞 Support
Break Bully v1.1.1: Because your health is too important to ignore! 💚
Helping developers worldwide maintain healthy work-life balance, and now helping build beautiful love stories too! 💍
