VSCode Pomodoro Timer
A minimal and elegant Pomodoro Timer that lives in your VSCode status bar. Stay focused and productive with timed work sessions and breaks.
GitHub Repository | Report Issues
Features
- 🎯 Minimal Interface: Lives in your status bar - no intrusive windows or popups
- ⏱️ Standard Pomodoro Technique:
- 25-minute focused work sessions
- 5-minute short breaks
- 15-minute long breaks after 4 work sessions
- 🔄 Smart Break System:
- Automatically suggests breaks after each session
- Long breaks after 4 completed Pomodoros
- Skip break option for flexibility
- 👀 Visual Feedback:
- Different icons for work and break periods
- Color-coded status bar for different states
- Progress tracking in tooltips
- 📊 Session Tracking:
- Counts completed Pomodoros
- Shows current session progress
- Maintains cycle count for long breaks
Installation
- Open VSCode
- Press
Ctrl+P / Cmd+P
- Type
ext install Monarch.monarch-pomodoro-timer
- Press Enter
Usage
Starting a Session
- Click the timer in the status bar, or
- Open command palette (
Ctrl+Shift+P / Cmd+Shift+P)
- Type "Pomodoro: Start Timer"
During a Session
- Timer shows in status bar with remaining time
- Click to pause/resume
- Notifications appear when sessions end
- Choose to take or skip breaks
Status Bar Indicators
⌚ Focus 25:00 - Work session in progress🕐 Break 05:00 - Break session in progress▶️ Pomodoro 25:00 - Ready to start- Different background colors for work and break periods
Break System
- 5-minute breaks after regular sessions
- 15-minute breaks after completing 4 Pomodoros
- Option to skip breaks if needed
- Option to delay new work sessions
Commands
| Command |
Description |
Pomodoro: Start Timer |
Start/Resume the timer |
Pomodoro: Toggle Timer |
Toggle between pause/resume |
Settings
Currently using default Pomodoro timings:
- Work Session: 25 minutes
- Short Break: 5 minutes
- Long Break: 15 minutes
- Long Break Interval: Every 4 sessions
Contributing
- Fork the repository: Fork
- Create your feature branch:
git checkout -b feature/my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin feature/my-new-feature
- Submit a pull request
Found a bug or have a feature request? Please open an issue.
Credits
License
This extension is licensed under the MIT License.
Release Notes
0.0.2
- Added icon credits and attribution
- Fixed package size optimization
- Removed circular dependencies
0.0.1
- Initial release
- Basic Pomodoro functionality
- Status bar integration
- Break management system
- Session tracking
| |
