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
• ⏸️ Pause and resume timer functionality
• 🖥️ Optional full screen or inline mode
• 🔔 Cross-platform desktop notifications
• 🎨 Clean, minimal terminal UI
• 🛠️ Custom commands when timers complete

Usage

Work sessions:

pomo              # Default work session (25m)
pomo 30m          # Custom duration

Break sessions:

pomo break        # Default break (5m)
pomo break 10m    # Custom duration

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

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: ~/my/icon

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.