PomoDomate CLI
The Pomodoro that lives in your terminal
Stay focused without leaving the command line: Pomodoro sessions, breaks and stats with a single command.
$ pomodomate
๐ PomoDomate โ 25:00
โโโโโโโโโโโโโโโโโโโโ 12:34
[space] pause ยท [s] skip ยท [q] quit
Installation
Install it with one command from crates.io, download the Linux binary from the releases page, or build it from source: github.com/Zapayox30/Pomodomate-cli/releases
$ cargo install pomodomate-cli
$ git clone https://github.com/Zapayox30/Pomodomate-cli.git
$ cd Pomodomate-cli
$ cargo build --release
Prebuilt binaries are published for Linux (x86_64 and aarch64). Building from source needs a stable Rust toolchain; the binary ends up in target/release/pomodomate. The x86_64 release binary ships with ambient sound; the aarch64 one does not (ALSA does not cross-compile). With cargo, add --features audio for sound.
Commands
| Command | Description |
|---|---|
pomodomate | Start the timer with your saved settings (-w 50 changes the duration for this run only) |
pomodomate stats | Print your session stats without opening the timer (--json for scripts and status bars) |
pomodomate daemon | Run the timer in the background so you can drive it from anywhere |
pomodomate ctl toggle | Send a command to the running daemon: toggle, pause, resume, skip, reset or quit |
The full reference, the guides and the configuration file are documented in the repository README.
Why a CLI?
Works offline
No account, no connection, no waiting. Just you and your terminal.
Lightweight and distraction-free
No tabs, no notifications: just a plain-text timer.
Open source
All the code on GitHub: read it, suggest improvements or fork it.
The PomoDomate spirit
The same Pomodoro technique as the web and mobile apps, in its most minimal form.
Follow the project on GitHub
The code, the releases and the guides live on GitHub, under the MIT license.
What PomoDomate CLI is
PomoDomate CLI is a Pomodoro timer that runs inside your terminal: one command starts the work and break cycle, with the Domate mascot drawn in the terminal, a desktop notification when each phase ends and a heatmap of the days you focused. It is a single Rust binary under the MIT license, and it works fully offline โ no account, no telemetry, everything stored on your own machine. It is published on crates.io (cargo install pomodomate-cli), prebuilt binaries for Linux (x86_64 and aarch64) are on GitHub, and you can also build it from source. It is a separate program from the web app: terminal sessions stay local and do not sync with your PomoDomate account yet.
Frequently asked questions
How do I install PomoDomate CLI?
The quickest route with Rust installed is cargo install pomodomate-cli โ the crate is published on crates.io. Without Rust, download the archive for your architecture from the releases page on GitHub, unpack it and move the pomodomate binary somewhere on your PATH โ for example: sudo install -m 755 pomodomate /usr/local/bin/. You can also clone the repository and run cargo build --release; the binary ends up in target/release/pomodomate.
What commands and shortcuts does it have?
Running pomodomate on its own opens the timer. pomodomate stats prints your totals without opening it, with --json for scripts and status bars and --by-tag to see where your pomodoros went; pomodomate daemon keeps the timer running in the background, while pomodomate status and pomodomate ctl read it and drive it from anywhere. Flags change the durations for a single run (-w, -b, -l, -i) and --mute silences sound and notifications; your defaults live in ~/.config/pomodomate/config.toml. Inside the timer, space starts and pauses, r resets, s skips the phase, h toggles the heatmap, d switches the clock typography, + and - adjust the minutes, ? opens the help and q quits.
Do terminal sessions count towards my PomoDomate account?
Not yet. The CLI is offline first: it keeps your history in a local file, asks for no account and sends nothing anywhere. Syncing with pomodomate.com is on the project roadmap but has not shipped, so coins, XP, weekly challenges and rankings only move when you use the web app.
Does it work on macOS or Windows?
The published releases are Linux binaries, and features such as desktop notifications and idle detection are built for Linux desktops, so there is no macOS or Windows download today. On those systems use the web version in your browser: it runs the same Pomodoro cycle and, with an account, keeps your stats.