Skip to main content
Pomo is distributed as a single binary with no external dependencies. Choose your installation method below based on your operating system.

​
Package managers

brew install --cask bahaaio/pomo/pomo
The Homebrew installation uses the --cask flag to install the tap. The Go installation requires Go 1.21 or later.

​
Pre-built binaries

Download pre-built binaries for your platform from the GitHub releases page. Available platforms:
  • macOS - Intel and Apple Silicon (M1/M2/M3)
  • Linux - x86_64, ARM64, and ARM
  • Windows - x86_64 and ARM64
1

Download the binary

Navigate to the latest release and download the appropriate binary for your system.For example, on macOS:
curl -LO https://github.com/Bahaaio/pomo/releases/latest/download/pomo-darwin-amd64
2

Make it executable

Add execute permissions to the binary:
chmod +x pomo-darwin-amd64
3

Move to PATH

Move the binary to a directory in your PATH:
sudo mv pomo-darwin-amd64 /usr/local/bin/pomo
4

Verify installation

Confirm Pomo is installed correctly:
pomo --version
Expected output:
pomo version 1.1.1

​
Build from source

For the latest development version or to contribute to Pomo, you can build from source.

​
Prerequisites

  • Go 1.21 or later - Download Go
  • Git - For cloning the repository

​
Build steps

1

Clone the repository

git clone https://github.com/Bahaaio/pomo
cd pomo
2

Build the binary

go build .
This creates a pomo binary in the current directory.
3

Install (optional)

Move the binary to your PATH:
# macOS/Linux
sudo mv pomo /usr/local/bin/

# Or add to your home bin directory
mv pomo ~/bin/
4

Verify the build

pomo --version
Building from source gives you access to the latest features but may include unreleased changes. For production use, we recommend using a stable release.

​
System requirements

Pomo has minimal system requirements:
  • Operating system - macOS 10.15+, Windows 10+, or any modern Linux distribution
  • Terminal - Any terminal emulator with 256 color support
  • Font (optional) - Nerd Font required for heatmap statistics display

​
Terminal compatibility

Pomo works in all modern terminals:
  • iTerm2, Terminal.app (macOS)
  • Windows Terminal, PowerShell (Windows)
  • GNOME Terminal, Konsole, Alacritty, Kitty (Linux)

​
Uninstallation

To remove Pomo from your system: 
brew uninstall pomo

​
Next steps

Quick start

Run your first Pomodoro session and learn the basics

Configuration

Customize Pomo to match your workflow

Build docs developers (and LLMs) love

Get started for freeTalk to us