Press enter.
Get to work.

A calm focus companion for your terminal. It runs your Pomodoro rhythm, reminds you to rest, and keeps score.

yay -S pomogo

Written in Rust. One small binary, no daemon.

                              FOCUS  ·  write the release notes                                                        ██  ██████      ██████  ██████                                                      ██  ██  ██  ██      ██      ██                                                      ██  ██████      ██████  ██████                                                      ██  ██  ██  ██      ██  ██                                                          ██  ██████      ██████  ██████                                    ━━━━━━━━━━━━━━━━━───────────────────────────────────────────────                                       break in 19m  ·  eyes in 7m                                     today 2h 35m of 4h  ▰▰▰▰▰▰▱▱▱▱  ·  6-day streak  ·  3 glasses of water                   enter pause  ·  n skip  ·  t task  ·  w water  ·  tab stats  ·  ? keys

            FOCUS  ·  write the release notes                        ██  ██████      ██████  ██████                      ██  ██  ██  ██      ██      ██                      ██  ██████      ██████  ██████                      ██  ██  ██  ██      ██  ██                          ██  ██████      ██████  ██████              ━━━━━━━━━━━─────────────────────────────────                 break in 19m  ·  eyes in 7m                today 2h 35m of 4h  ▰▰▰▰▰▰▱▱▱▱  ·  6-day streak         enter pause  ·  n skip  ·  t task  ·  w water

Tokyo Night

Set it up once. Then just work.

The first launch asks five questions. After that PomoGo keeps the rhythm, looks after you, and writes everything down.

Five questions, once

Answer on first launch, or any time with pomogo setup.

1/5Focus rhythmClassic 25/5, Steady 50/10 or Deep 90/20
2/5Daily goalHow many hours of focus you aim for
3/5AutopilotBreaks and focus start on their own
4/5Body remindersEyes, water and stretching
5/5NotificationsDesktop notices and sounds

Autopilot

Focus rolls into a break and back again. No timers to restart.

focusbreaklong break

Looks after you

◉Rest your eyesevery 20 min
◍Drink some waterevery 45 min
↟Stand up and stretchevery hour

Counted in focus time only. A break resets what it already covers.

A daily goal

today 2h 35m of 4h

With your streak and glasses of water, in the TUI and in your bar.

Remembers every session

Tasks, projects, streaks and notes in a local SQLite file. Weekly reports in Markdown, exports in CSV or JSON.

pomogo report > week.md

Make it yours.

Every frame below was rendered by PomoGo itself. Pick a moment, a layout and any of 41 themes, including all of Omarchy's.

                              FOCUS  ·  write the release notes                                                        ██  ██████      ██████  ██████                                                      ██  ██  ██  ██      ██      ██                                                      ██  ██████      ██████  ██████                                                      ██  ██  ██  ██      ██  ██                                                          ██  ██████      ██████  ██████                                    ━━━━━━━━━━━━━━━━━───────────────────────────────────────────────                                       break in 19m  ·  eyes in 7m                                     today 2h 35m of 4h  ▰▰▰▰▰▰▱▱▱▱  ·  6-day streak  ·  3 glasses of water                   enter pause  ·  n skip  ·  t task  ·  w water  ·  tab stats  ·  ? keys

            FOCUS  ·  write the release notes                        ██  ██████      ██████  ██████                      ██  ██  ██  ██      ██      ██                      ██  ██████      ██████  ██████                      ██  ██  ██  ██      ██  ██                          ██  ██████      ██████  ██████              ━━━━━━━━━━━─────────────────────────────────                 break in 19m  ·  eyes in 7m                today 2h 35m of 4h  ▰▰▰▰▰▰▱▱▱▱  ·  6-day streak         enter pause  ·  n skip  ·  t task  ·  w water

The clock, the task, and nothing else.

On Omarchy your terminal already wears this theme, background included.

Moment

Layout

Theme Osaka Jade

Omarchy

Built in

Omarchy

At home in your bar.

A widget for omarchy-shell counts down the running segment and swaps its icon when PomoGo asks you to take care of yourself. Click to open, right click to pause.

The Omarchy top bar with the PomoGo widget counting down next to the clock

Add the widget

With PomoGo installed:

pomogo omarchy install

Or through Omarchy's plugin manager:

omarchy plugin add https://github.com/Ibnu-Afdel/omarchy-pomogo.git --enable

To remove it:

omarchy plugin remove pomogo.timer

Bind it to a key

In ~/.config/hypr/bindings.lua:

-- open PomoGo
o.bind("SUPER + ALT + P", "PomoGo",
  { tui = "pomogo", focus = true })

-- start or pause it from anywhere
o.bind("SUPER + SHIFT + ALT + P",
  "PomoGo start/pause", "pomogo toggle")

Colors follow omarchy theme set as it happens.
Pauses while the lock screen is up.

Install.

PomoGo is a single Rust binary of about 6 MB. Sessions live in a local SQLite file, and nothing runs in the background when it's closed.

yay -S pomogo

pomogo

The AUR package builds the Rust source and replaces the older pomogo-bin.

sudo dnf install cargo gcc

git clone https://github.com/Ibnu-Afdel/pomogo-rs && cd pomogo-rs

./install.sh

Installs to ~/.local/bin with completions and a desktop entry. On other distros, get Rust from rustup.rs. Remove it with ./install.sh --uninstall.

Everyday commands

pomogo: Open the focus screen
pomogo start writing: Start with a profile or project
pomogo toggle: Start or pause from a keybinding
pomogo stats --week: Your week at a glance
pomogo report: Weekly Markdown report
pomogo status --format waybar: Feed Waybar, tmux or Starship

Keys

enter: start, pause, resume
n: skip ahead
t: set the task
w: log a glass of water
d: plan a deep focus block
tab: stats
T: next theme
?: every key