terminal focus companion · v2.0.0

Focus from the terminal.

PomoGo is a keyboard-first focus companion for developers — quick pomodoro sessions, deep-focus blocks, task tracking, themes, layouts, stats, and status integrations. One small binary. Stays out of your way.

19Built-in themes
11Built-in layouts
4Sound profiles
4Ambient effects
$yay -S pomogo-bin
Install from AURView on GitHubSee keybindings
pomogo — tokyo-night · classic
╭────────────────────────────────────────────────────╮
│ │
│ ██ █ █ █ ██ │
│ █ █ █ ● █ █ │
│ ██ ████ █ ██ │
│ █ █ ● █ █ │
│ ████ █ █ ████ │
│ │
│ Focus │
│ ● ● ○ ○ │
│ Project: pomogo │
│ Task: ship the landing page │
│ git:feat/landing │
│ Deep work in progress │
│ │
│ ━━━━━━━━━━━━━━━━━━━━──────────────────────────── │
│ │
│ s start · space pause · n skip · t task · ? help · q quit │
│ │
╰────────────────────────────────────────────────────╯
try it fast

Two commands and you're focusing.

$yay -S pomogo-bin
$pomogo

Prefer Go? go install github.com/Ibnu-Afdel/pomogo/cmd/pomogo@latest

interactive preview

Try every theme, layout & state — live.

This is the real TUI, rendered in your browser from PomoGo's own theme and layout definitions. Swap a theme and the whole terminal morphs.

pomogo — tokyo-night · classic
╭────────────────────────────────────────────────────╮
│ │
│ ██ █ █ █ ██ │
│ █ █ █ ● █ █ │
│ ██ ████ █ ██ │
│ █ █ ● █ █ │
│ ████ █ █ ████ │
│ │
│ Focus │
│ ● ● ○ ○ │
│ Project: pomogo │
│ Task: ship the landing page │
│ git:feat/landing │
│ Deep work in progress │
│ │
│ ━━━━━━━━━━━━━━━━━━━━──────────────────────────── │
│ │
│ s start · space pause · n skip · t task · ? help · q quit │
│ │
╰────────────────────────────────────────────────────╯
themeTokyo Night
layout
state
ambient
what it does

Built for people who work in terminals.

Coding sessions, study blocks, writing, debugging, reading docs — any work where you want a visible timer without leaving the terminal.

Quick Focus

Start a classic focus session in one keypress and move naturally through work and break cycles.

Deep Focus

Pick a long deep-work block and let PomoGo manage the rhythm while you focus on the whole countdown.

Tasks & Projects

Label what you are working on, group sessions by project, and review your focus history later.

Stats & Recaps

Review today's focus, current streaks, and the last completed block without leaving the terminal.

Status Integrations

Expose focus status to terminal workflows and desktop bars like Waybar and tmux.

themes · 19

Nineteen palettes, from Tokyo Night to Gruvbox.

Click any theme to load it into the playground above.

layouts · 11

One timer, eleven ways to wear it.

From tiny status bars to wide command centers. Click to preview.

sounds & ambient

Customization beyond colors.

Sound profiles

softSubtle focus cue and completion chime.
bellClassic terminal bell cues.
dialogDesktop notification style.
serviceLogin / logout style transitions.

Sounds are user-triggered only. Nothing auto-plays.

Ambient effects

noneNo background effect.
starsQuiet blinking star field.
snowFalling snow-like particles.
rainTerminal rain effect.

Toggle these live in the playground's ambient control.

keyboard-first

Everything important is one keypress away.

sStart the current focus session
spacePause / resume a running timer
nSkip current segment
tEdit task description
pEdit project category
dChoose a Deep Focus duration
tabToggle statistics screen
yCopy stats summary to clipboard
TCycle theme
LCycle layout
aChoose sound profile
SToggle Zen / Screenshot mode
eCycle ambient background effects
vCycle task verb labels
rReset session
escBack / close overlay
?Show help menu
qQuit
release & trust

Installable and maintained.

PomoGo ships as a small Go binary with GitHub release archives and checksum validation. Arch users install the packaged binary from the AUR, pinned to fixed release asset checksums.

AUR · pomogo-binReleasesv2.0.0 notes