Avocado
25:00
Stay focused!

Focus, with a
little friend.

A floating desktop pet that lives on your screen and helps you stay focused with the Pomodoro technique.

Install View on GitHub
Features

Everything you need
to stay focused.

A minimal, beautiful Pomodoro timer that doesn't get in your way. Your pet stays on top while you work.

🥑

Animated Pets

Cute sprites that react to your timer. Idle, working, celebrating, waving — your pet has personality.

🪟

Always on Top

Floats above your windows without stealing focus. Draggable, click-through, non-intrusive.

⌨️

Keyboard Shortcuts

Cmd+Shift+P to pause, R to reset, Q to quit. Control everything without touching the mouse.

📊

Session Stats

Track your focus time, streaks, and daily sessions. See your progress over time.

🔔

Sounds & Notifications

Subtle chimes when phases change. macOS notifications when sessions complete. Configurable volume.

⚙️

Fully Configurable

Custom durations, messages, volume, default pet. All settings persist in ~/.pomo-pet/config.json.

Install

Get started in seconds.

One command. That's it.

# Install with Homebrew
brew tap someshfengde/pomo-pet
brew install pomo-pet

# Launch
pomo-pet start
# One-line install
curl -sSL https://raw.githubusercontent.com/
  someshfengde/pomo_pet/main/install.sh | bash

# Launch
pomo-pet start
# Clone and install
git clone https://github.com/
  someshfengde/pomo_pet.git ~/.pomo-pet
cd ~/.pomo-pet
uv sync
make install

# Launch
pomo-pet start
Controls

Effortless interaction.

Mouse, keyboard, or drag — your pet responds to everything.

Move Pet
Click + Drag
Pause / Resume
Single Click
Reset Timer
Double Click
Pause / Resume
⌘⇧P
Reset Timer
⌘⇧R
Quit
⌘⇧Q
Pet Wave
Hover
Quit
Q / ESC
CLI

Command line first.

pomo-pet start              # Launch default pet
pomo-pet start cat         # Launch specific pet
pomo-pet list              # See available pets
pomo-pet stats             # View statistics
pomo-pet config            # View settings
pomo-pet update            # Self-update
pomo-pet --version        # Show version

pomo-pet --work 30 --break 10 start
pomo-pet --volume 50 start
pomo-pet --messages-file msgs.txt start