Metadata-Version: 2.4
Name: richpomo
Version: 0.1.0
Summary: A polished Rich-powered Pomodoro timer for your terminal
Project-URL: Homepage, https://github.com/example/richpomo
Project-URL: Repository, https://github.com/example/richpomo
Author: richpomo
License: MIT
License-File: LICENSE
Keywords: cli,pomodoro,productivity,rich,timer
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.12.0
Description-Content-Type: text/markdown

# richpomo

A polished [Rich](https://github.com/Textualize/rich)-powered Pomodoro timer for your terminal.

```bash
pip install richpomo
pomo
```

## Features

- Classic Pomodoro defaults: **25** focus / **5** short break / **15** long break
- Live countdown with progress bar and session counter
- Interactive menu or one-shot commands
- Config saved under `~/.config/richpomo/config.json`
- Terminal bell when a phase completes
- Ctrl+C cancels cleanly back to the menu

## Install

### From PyPI 

```bash
pip install richpomo
```

### From this repo

```bash
cd richpomo
pip install -e .
```

## Usage

### Interactive menu

```bash
pomo
```

### Commands

```bash
# Start a focus session (uses saved / default duration)
pomo start

# Demo a 5-second focus session
pomo start --seconds 5

# Short break
pomo break

# Long break
pomo break --long

# Show or update config
pomo config
pomo config --focus 25 --short 5 --long 15 --until 4
```

You can also run:

```bash
python -m richpomo
```


## License

MIT
