Skip to content

kareem2099/dotsense

BranchesTags

Repository files navigation

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

  1. Open VSCode
  2. Go to Extensions (Ctrl+Shift+X)
  3. Search for "DotSense"
  4. 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 reminder
  • DotSense: Toggle Reminders - Enable/disable break reminders
  • DotSense: Open Settings - Access extension configuration
  • DotSense: Take a Break - Start a break session immediately

Exercise Commands

  • DotSense: Quick Stretch - Launch a quick stretching exercise
  • DotSense: Eye Exercise - Start an eye health exercise
  • DotSense: Breathing Exercise - Begin a breathing exercise

Advanced Features

  • DotSense: Change Workout Model - Switch between work-rest timing models
  • DotSense: Force Unblock Screen - Emergency screen unblock (admin feature)
  • DotSense: Create Custom Exercise - Add a new custom exercise
  • DotSense: Show Custom Exercise Library - Browse your custom exercises
  • DotSense: Trigger Git Break Suggestion - Check productivity and suggest breaks
  • DotSense: 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 analysis
  • DotSense: Check Burnout Risk - Get AI assessment of current fatigue levels
  • DotSense: Predict Productivity - Forecast performance for different times/activities
  • DotSense: Get Work Pattern Insights - View AI-recommended work-rest optimization
  • DotSense: Export Activity Data - Download your productivity data as JSON/CSV
  • DotSense: 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 activities
  • DotSense: Create Personal Wellness Routine - Generate AI-customized daily wellness schedule
  • DotSense: Predict Exercise Success - See completion likelihood for different wellness activities
  • DotSense: Get Wellness Notification Analytics - View how well ML-optimized notifications perform
  • DotSense: 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 rest
    • who-45min-work-15min-rest: WHO recommended
    • who-1hour-work-30min-rest: Extended sessions
    • who-2hour-work-1hour-rest: Long work blocks
    • who-90min-work-30min-rest: Research-based
    • custom-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

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new features
  5. 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! 💍

About

No description, website, or topics provided.

Resources

Readme

License

MIT license

Contributing

Contributing
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

2 tags

Sponsor this project

  •  
Learn more about GitHub Sponsors

Packages

No packages published

Languages