pomo-tui 1.1

Terminal-based Pomodoro timer with TUI and sound notifications

pomo-tui

A terminal-based Pomodoro timer with a real-time ASCII digital clock. Designed for developers who want to stay focused without leaving the terminal.

---

✨ Features

• Real-time ASCII digital clock display
• Pomodoro workflow with WORK / BREAK cycles
• Color-coded phases
  • 🔴 WORK
  • 🔵 BREAK
  • 🟡 PAUSED
• Keyboard control
  • p: pause / resume
  • Ctrl + C: quit
• Terminal bell notification on phase change
• Safe fallback rendering on small terminal windows
• Fully terminal-based with no GUI dependency

---

🚀 Installation

pip

pip install pomo-tui

pipx

pipx install pomo-tui

---

🎯 Usage

Start with the default Pomodoro flow:

pomo

Run a custom session:

pomo --work 25 --break 5 --cycles 4

Run continuously until interrupted:

pomo --cycles 0

Option	Description	Default
--work	Work duration in minutes	25
--break	Break duration in minutes	5
--cycles	Number of work/break cycles, 0 = infinite	0

Keyboard controls

Key	Action
p	Pause / Resume
Ctrl + C	Quit

Notes

• --work and --break must be positive integers
• --cycles must be a non-negative integer
• Very small terminals automatically fall back to compact text rendering

---

🛠️ Development Setup

git clone https://github.com/newbie1223/pomodoro-cli.git
cd pomodoro-cli
python3 -m venv .venv
source .venv/bin/activate
pip install -e .[test]
pytest

If your environment does not support extras installation yet, use:

pip install -e .
pip install pytest
pytest

---

📦 Package Information

• Package name: pomo-tui
• CLI command: pomo
• Python requirement: >=3.9