A pomodoro timer that lives in your terminal. Built with Textual, so it has a real TUI — progress bar, keyboard shortcuts, daily stats — without dragging in a heavy GUI.
From source:
git clone https://github.com/<you>/pomo
cd pomo
pip install -e .pomo| Key | Action |
|---|---|
| space | start, pause, or resume the current phase |
| s | skip to the next phase |
| r | reset all stats and start over |
| q | quit |
The default cycle is the classic pomodoro: four 25-minute focus phases, separated by 5-minute short breaks, with a 15-minute long break after every fourth focus phase. When a phase completes, the terminal bell rings and the session is recorded in the day's stats; the next phase is queued but does not auto-start, so you can take the break when you're actually ready.
Settings live in pomo/state.py and can be tweaked there for now. A config file is on the to-do list.
- Python 3.10+
MIT