OpenPomo

A lightweight, terminal-based Pomodoro timer built with OpenTUI and Bun.

Prerequisites

• Bun must be installed on your system.
• Note: Desktop notifications currently rely on notify-send, which is available by default on most Linux desktop environments.

Installation

Clone the repository and install the dependencies:

git clone https://github.com/yourusername/openpomo.git
cd openpomo
bun install

Usage

To start the Pomodoro timer in your terminal:

bun dev

If you are developing or troubleshooting the application, you can launch it with the debug console enabled:

bun dev --debug

Keyboard Controls

• Space: Play or pause the timer.
• r: Reset the current timer session.
• Tab: Cycle through the different modes (Focus, Short Break, Long Break).

Roadmap

• Support for cross-platform notifications (macOS / Windows).
• Auto-mode switching after focus sessions.
• Configurable session times and settings.

License

This project is licensed under the MIT License - see the LICENSE file for details.