A developer-first CLI Pomodoro tool with built-in Git integration, streak tracking, session history, and sound alerts. Designed to keep you in the flow while working on projects.
- ⏱️ Simple Pomodoro work/break timer
- ✅ Auto Git commit prompt after each work session
- 📊
--history: View all your sessions in a rich table - 🔁
--streak: See how consistent you’ve been today and this week - 🔔 Sound alert when timers finish
- 📁 CSV log file (
session_log.csv) stores all your sessions locally
pip install pomodevMake sure your Python user bin is in your PATH, or use:
source ~/.zshrc # or your shell config filepomodevBy default, this starts a 25-minute work session, followed by a 5-minute break, and prompts you to Git commit when done.
| Flag | Description |
|---|---|
--work |
Set custom work duration (minutes) |
--break-time |
Set custom break duration (minutes) |
--no-commit |
Skip Git commit prompt |
--history |
Show all logged sessions |
--streak |
Display your current day/week work streak |
pomodevpomodev --work 50 --break-time 0 --no-commitpomodev --historypomodev --streakAll sessions are logged to session_log.csv in the working directory.
If you:
- Work on side projects and want accountability
- Want lightweight time tracking tied to Git activity
- Like working in the terminal and hate bloated apps
This is for you.
- Preset durations via config
- Web dashboard (
--export-html) - Live UI with Textual
- Daily goal + streak gamification
Built with ❤️ by Dhruv