pomo

pomo — Terminal Pomodoro Timer

A simple, customizable Pomodoro timer for your terminal, built with Bubble Tea.

Features

• 🍅 Work and break timer sessions
• 📊 Real-time progress bar visualization
• ⌨️ Keyboard shortcuts to adjust time mid-session
• 🖥️ Optional full screen or inline mode
• 🔔 Cross-platform desktop notifications
• 🎨 Clean, minimal terminal UI
• 🛠️ Custom commands when timers complete

Usage

# Start a work session (default)
pomo

# Explicit work session
pomo work

# Start a break session
pomo break

Installation

Install with Go

go install github.com/Bahaaio/pomo@latest

Or, build from source

git clone https://github.com/Bahaaio/pomo
cd pomo
go build .

Alternatively, download pre-built binaries from the releases page.

Configuration

pomo looks for its config file in:

1. ~/.config/pomo/pomo.yaml
2. Current directory (./pomo.yaml)

Example pomo.yaml:

fullScreen: true

work:
  duration: 25m
  title: work session

  # cross-platform notifications
  notification:
    enabled: true
    title: work finished 🎉
    message: time to take a break
    icon: ./pomo.png

break:
  duration: 5m

  # will run after the session ends
  then:
    - spd-say 'Back to work!'

Check out pomo.yml for a full example with all options.

Key Bindings

License

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