A comprehensive productivity extension for Visual Studio Code that helps you maintain focus, track coding sessions, and build healthy work habits through the Pomodoro Technique and advanced analytics.
- Smart Pomodoro Sessions: Customizable focus sessions (default 25 minutes) with automatic break reminders
- Intelligent Break System: Smart break suggestions with healthy activities and flexible timing
- Real-time Status Tracking: Live session timer in your status bar with visual indicators
- Live Dashboard: Beautiful, real-time dashboard with progress visualization and session metrics
- Comprehensive Statistics: Track daily, weekly, and total focus time with detailed completion rates
- Streak Tracking: Build and maintain focus streaks with visual progress indicators
- Achievement System: Unlock achievements for consistent focus habits and milestones
- Motivational Messages: Optional inspirational notifications during focus sessions
- Break Activity Suggestions: Curated list of healthy break activities for physical and mental wellness
- Goal Setting: Set and track daily focus time goals with progress visualization
- Sound Notifications: Audio feedback for session starts, completions, and breaks
- Flexible Session Duration: Adjust focus and break periods to match your workflow
- Sound Controls: Enable/disable audio notifications with multiple playback methods
- Motivation Settings: Control frequency and type of motivational messages
- Auto-Break Options: Configure automatic break suggestions after completed sessions
- Open Visual Studio Code
- Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Search for "Focus Time Tracker Enhanced"
- Click Install
- The extension will activate automatically and show a status bar item
- Click the "Ready" status bar item to start your first focus session
- Work focused for the duration (default: 25 minutes)
- Take the suggested break when prompted
- Repeat to build your focus habit
- Command Palette:
Focus Time: Show Live Dashboard - Status Bar: Click during an active session
- View real-time progress, achievements, and statistics
- Command Palette:
Focus Time: Show Advanced Statistics - Track your focus journey with detailed analytics
- Monitor streaks, completion rates, and productivity trends
All commands are available through the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
Focus Time: Toggle Focus Session- Start or stop a focus sessionFocus Time: Show Live Dashboard- Open the real-time productivity dashboardFocus Time: Show Advanced Statistics- View detailed analytics and progressFocus Time: Take Quick Break- Get a quick break activity suggestionFocus Time: Show Motivational Message- Display an inspirational messageFocus Time: Open Settings- Access extension configurationFocus Time: Reset All Statistics- Clear all tracking data (with confirmation)
Access settings via File > Preferences > Settings and search for "Focus Time Tracker":
focusTimeTracker.sessionDuration(default: 25) - Focus session length in minutes (5-120)focusTimeTracker.breakDuration(default: 5) - Break duration in minutes (1-30)focusTimeTracker.dailyGoal(default: 120) - Daily focus time goal in minutes (30-480)
focusTimeTracker.soundEnabled(default: true) - Enable audio notificationsfocusTimeTracker.soundMethod(default: "auto") - Audio playback method (system/webview/auto)
focusTimeTracker.enableMotivation(default: true) - Show motivational messages during sessionsfocusTimeTracker.motivationInterval(default: 10) - Minutes between motivational messages (5-60)focusTimeTracker.autoBreak(default: true) - Automatically suggest breaks after sessions
- Start Small: Begin with shorter sessions (15-20 minutes) if 25 minutes feels overwhelming
- Consistency Over Perfection: Regular short sessions are better than occasional long ones
- Honor Your Breaks: Taking breaks prevents burnout and maintains long-term productivity
- Track Your Progress: Use the dashboard to identify your most productive patterns
The extension suggests various healthy break activities:
- Physical movement and stretching
- Eye rest exercises (20-20-20 rule)
- Hydration reminders
- Mindfulness and breathing exercises
- Brief social connections
- Environment Setup: Minimize distractions before starting sessions
- Task Planning: Know what you'll work on before starting the timer
- Session Goals: Set specific, achievable goals for each focus period
- Regular Reviews: Use statistics to understand your focus patterns
- No Sound: Check
soundEnabledsetting and system volume - Linux Users: Ensure audio players (aplay, paplay, or similar) are installed
- Alternative: Try changing
soundMethodto "webview" in settings
- The extension uses minimal resources and runs efficiently in the background
- Dashboard updates automatically every 30 seconds when open
- Session data is stored locally in VS Code's storage
- Session History: Automatically maintains last 1000 sessions
- Statistics Reset: Use "Reset All Statistics" command if needed
- Data Persistence: Session data survives VS Code restarts
- All data is stored locally in VS Code's extension storage
- No data is transmitted to external servers
- Session history and statistics remain private to your installation
We welcome contributions to improve Focus Time Tracker Enhanced:
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
git clone https://github.com/yourusername/focus-time-tracker.git
cd focus-time-tracker
npm install
npm run compile- Issues: Report bugs or request features on GitHub Issues
- Documentation: Comprehensive guides available in the repository wiki
- Community: Join discussions and share productivity tips
MIT License - see LICENSE file for details.
- Inspired by the Pomodoro Technique by Francesco Cirillo
- Built with the VS Code Extension API
- Icons and design elements from various open-source contributors
Focus Time Tracker Enhanced - Transform your coding productivity, one focused session at a time.