pomo

pomo — Terminal Pomodoro Timer

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

Features

• 🍅 Work and break timer sessions
• 🔗 Task chaining with user confirmation prompts
• 📊 Real-time progress bar visualization
• ⌨️ Keyboard shortcuts to adjust time mid-session
• ⏸️ Pause and resume sessions
• ⏭️ Skip to next session
• 🔔 Cross-platform desktop notifications
• 🎨 Clean, minimal terminal UI with ASCII art timer fonts
• 🛠️ Custom commands when timers complete

Desktop Notifications

pomo sends native desktop notifications when sessions complete

Timer Fonts

mono12	rebel
ansi	ansiShadow

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:

# prompt to continue after session completion
# false = exit when done
askToContinue: true

asciiArt:
  # use ASCII art for timer display
  enabled: true

  # available fonts: (mono12, rebel, ansi, ansiShadow)
  # default: mono12
  font: ansiShadow

  # color of the ASCII art timer
  # hex color or "none"
  color: "#5A56E0"

work:
  duration: 25m
  title: work session

  # cross-platform notifications
  notification:
    enabled: true
    title: work finished 🎉
    message: time to take a break
    icon: ~/my/icon.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

Timer Controls

Skip button skips directly to the next session, bypassing any prompts

Confirmation Dialog

License

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