pomo

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #golang #android #windows #awesome #cli #kubernetes #pytorch #ios #openai #mcp

(★ 9)

Terminal-based pomodoro timer with TUI

pomo Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# pomo

A terminal-based pomodoro timer with an interactive TUI, session tracking, and statistics.

![pomo screenshot](https://raw.githubusercontent.com/lostf1sh/pomo/main/assets/screenshot.png)

## Features

- Full-screen TUI with large ASCII timer display
- Work / Short Break / Long Break cycle with auto-advance
- Session persistence with BoltDB — your history survives restarts
- Resume unfinished sessions after closing the TUI
- Statistics with streak tracking, daily goals, and per-task breakdown
- Desktop notifications + terminal bell
- Configurable durations and intervals

## Installation

### Arch Linux (AUR)

```bash
# Prebuilt binary (no Go required)
yay -S pomo-cli-bin

# Or build from source
yay -S pomo-cli
```

### From source

```bash
go install github.com/lostf1sh/pomo@latest
```

### Manual build

```bash
git clone https://github.com/lostf1sh/pomo.git
cd pomo
go build -o pomo .
```

## Usage

```bash
# Start a pomodoro session
pomo start --task "coding"

# Start with custom work duration
pomo start --task "reading" --work 45m

# Resume the last unfinished session
pomo resume

# Running pomo without a subcommand also starts a session
pomo
```

### Keyboard Shortcuts

| Key | Action |
|-----|--------|
| `s` | Start / Pause |
| `r` | Reset current segment |
| `k` | Skip to next segment |
| `q` | Quit |
| `?` | Toggle help |

### Statistics

```bash
# All-time stats
pomo stats

# Filter by task
pomo stats --task "coding"

# Filter by period
pomo stats --period today
pomo stats --period week
pomo stats --period month

# Machine-readable output
pomo stats --json
```

### Configuration

```bash
# Show current config
pomo config show

# Modify settings
pomo config set --work 30m --short-break 10m
pomo config set --long-break 20m --interval 3
pomo config set --daily-goal 8
pomo config set --desktop false --bell true
pomo config set --theme dracula
```

Default configuration:

| Setting | Default |
|---------|---------|
| Work duration | 25m |
| Short break | 5m |
| Long break | 15m |
| Long break interval | 4 pomodoros |
| Daily goal | disabled |
| Desktop notifications | on |
| Terminal bell | on |
| Theme | `default` |

### Themes

pomo comes with 7 built-in color themes:

| Theme | |
|-------|---|
| `default` | Classic red/green/blue |
| `catppuccin-mocha` | Pastel warmth |
| `dracula` | Dark purple aesthetic |
| `gruvbox` | Retro earthy tones |
| `nord` | Arctic minimal |
| `tokyo-night` | Neon city vibes |
| `solarized` | Precision colors |

```bash
# List available themes
pomo theme list

# Set a theme
pomo config set --theme dracula
# or
pomo theme set nord

# Preview colors
pomo theme preview catppuccin-mocha
```

### Sync / Backup

```bash
# Export all data
pomo sync export --output ~/pomo-backup.json

# Import (merge with existing)
pomo sync import ~/pomo-backup.json

# Import (replace all data)
pomo sync import ~/pomo-backup.json --replace

# Check database info
pomo sync status
```

## Data Storage

| File | Location |
|------|----------|
| Config | `~/.config/pomo/config.json` |
| Database | `~/.local/share/pomo/pomo.db` |

## License

MIT

pomo

pomo Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

pomo

pomo Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README