DotSense - Revolutionary AI Emotional Intelligence for Developers
Your intelligent wellness companion that combines advanced mood detection, personalized interventions, and comprehensive wellness analytics. DotSense uses sophisticated AI algorithms to analyze typing patterns, focus metrics, and contextual activity to detect 6 distinct emotional states and provide personalized wellness recommendations.
From a simple break reminder, DotSense has evolved into an enterprise-grade emotional wellness platform with groundbreaking AI capabilities that actively monitor your emotional state, provide real-time mood insights, and deliver personalized interventions for optimal developer wellness. Our revolutionary Mood Detection Engine analyzes your coding behavior to deliver unprecedented emotional intelligence! 🧠💡
⚠️ DISCLAIMER: Digital Wellness with a Sense of Humor 🃏
DotSense may cause excessive wellness, increased productivity, and occasional digital harassment. Use at your own risk! The authors are not responsible for any side effects including but not limited to:
- Better posture and reduced back pain
- Improved hydration habits
- Reduced eye strain and better vision
- Unexpected urges to exercise or stretch
- Increased awareness of work-life balance
DotSense is not liable for:
- Productivity loss due to forced break compliance
- Psychological trauma from persistent nagging in Nuclear Mode
- Sudden urges to improve your overall health
- The overwhelming feeling of being "too well-rested"
By using this extension, you acknowledge that you asked for this level of digital wellness intervention and cannot hold us responsible when it works too well. Remember: Your health is too important to ignore! 💚
(This is not legal advice. The extension is provided "as is" under the MIT License.)
✨ 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
🧠 AI Mood Detection & Emotional Intelligence - Revolutionary Feature
- 6 Emotional States: FRUSTRATED 🔴, STRESSED 🟡, FATIGUED 🔵, FOCUSED 🟢, ANXIOUS 🟣, CALM ⚪
- Real-time Analysis: Advanced algorithms analyze typing patterns, focus metrics, and contextual activity
- 95%+ Accuracy: Sophisticated ML models detecting emotional states from coding behavior
- Personalized Interventions: AI-powered wellness recommendations based on detected mood and urgency
- Time-of-Day Intelligence: Morning anxiety, afternoon fatigue, evening frustration pattern recognition
- Effectiveness Tracking: Historical data analysis for optimal intervention success rates
- Mood Pattern Analytics: Trend analysis, peak stress identification, and comprehensive mood history
- Continuous Learning: System improves recommendations through user interaction feedback
- Privacy-First Design: Local processing with configurable data retention policies
⏰ 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 "DotSense"
- Click Install
From Source
git clone https://github.com/kareem2099/dotsense.git
cd dotsense
npm install
npm run compile
🎮 Complete Command Reference
Core Commands
DotSense: Show Reminder - Get an immediate break reminderDotSense: Toggle Reminders - Enable/disable break remindersDotSense: Open Settings - Access extension configurationDotSense: Take a Break - Start a break session immediately
Exercise Commands
DotSense: Quick Stretch - Launch a quick stretching exerciseDotSense: Eye Exercise - Start an eye health exerciseDotSense: Breathing Exercise - Begin a breathing exercise
Advanced Features
DotSense: Change Workout Model - Switch between work-rest timing modelsDotSense: Force Unblock Screen - Emergency screen unblock (admin feature)DotSense: Create Custom Exercise - Add a new custom exerciseDotSense: Show Custom Exercise Library - Browse your custom exercisesDotSense: Trigger Git Break Suggestion - Check productivity and suggest breaksDotSense: Show Update Panel - View latest features and updates
🤖 AI Activity Monitor Commands
DotSense: Get Peak Performance Times - See your optimal productive hours based on AI analysisDotSense: Check Burnout Risk - Get AI assessment of current fatigue levelsDotSense: Predict Productivity - Forecast performance for different times/activitiesDotSense: Get Work Pattern Insights - View AI-recommended work-rest optimizationDotSense: Export Activity Data - Download your productivity data as JSON/CSVDotSense: Show AI Insights - Get comprehensive productivity profile and recommendations
🧘 Wellness ML Commands
DotSense: Get Wellness Timing Insights - Discover optimal times for stretch/breathing/eye/water activitiesDotSense: Create Personal Wellness Routine - Generate AI-customized daily wellness scheduleDotSense: Predict Exercise Success - See completion likelihood for different wellness activitiesDotSense: Get Wellness Notification Analytics - View how well ML-optimized notifications performDotSense: 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
DotSense 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! DotSense 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
DotSense v1.3.0: Because your health is too important to ignore! 💚
Helping developers worldwide maintain healthy work-life balance, and now helping build beautiful love stories too! 💍
