tomat(1)

📦
version 2.15.0 · 2 versions
, in nixpkgs unstable

✨ tomat — like, the Pomodoro timer of your dreams ✨

okay so bestie, picture this: a Pomodoro timer that lives in your terminal, from the General Commands Manual, section 1. That's tomat(1). She's cross-platform, she's got daemon energy, and she's literally about to change your whole focus game. 💅

🌸 SYNOPSIS 🌸

tomat [-q|--quiet] [-h|--help] [-V|--version] <subcommands>

🎀 DESCRIPTION 🎀

tomat is a cross-platform Pomodoro timer with a daemon-based architecture — and before you ask, yes, that's the serve. 🫶 She's designed for command-line use and for seamless integration with status bars (waybar girlies, this one's for you).

Here's the iconic part: she uses a Unix socket for client-server communication. Which means your timer state persists across client restarts and system suspend/resume. No cap. Your pomodoro is not going to ghost you. 😭

🔥 OPTIONS 🔥

  • -q, --quiet — the "shhh, I'm focusing" flag. Suppresses routine output, but keeps your command results and errors intact. So you still get the tea, just quieter. 🤫
  • -h, --help — prints the help. (She notes: see a summary with -h.) 👑
  • -V, --version — prints the version. Slay, short and sweet.

🦋 SUBCOMMANDS 🦋

the whole squad, one by one:

  • tomat-daemon(1) — manages the background daemon. she's the backbone, the main character holding it all together 💀
  • tomat-start(1) — starts a new Pomodoro session. go go go ⭐
  • tomat-reset(1) — resets the current phase to its full duration. a little refresh moment ✨
  • tomat-stop(1) — stops the current session. okay bye 🙈
  • tomat-status(1) — gets the current timer status. the vibe check, fr fr
  • tomat-watch(1) — continuously outputs status updates. she does not stop talking and we love her for it 💖
  • tomat-skip(1) — skips to the next phase. moving on, no hard feelings 🧚
  • tomat-pause(1) — pauses the current timer. brb 🎀
  • tomat-resume(1) — resumes a paused timer. we're so back 🌈
  • tomat-toggle(1) — toggles timer pause/resume. the indecision icon 💜
  • tomat-help(1) — prints this message or the help of the given subcommand(s). ask away, bestie 🌸

💜 EXTRA 💜

💫 EXAMPLES 💫

the moment you've all been waiting for — real, honest-to-god usage:

# Start daemon and begin a session
tomat daemon start
tomat start

# Custom session durations
tomat start --work 45 --break 15

# Check status (outputs JSON for waybar)
tomat status

# Toggle pause/resume
tomat toggle

For more information, visit: https://github.com/jolars/tomat 🦋

⭐ VERSION ⭐

v2.15.0 — she's fresh, she's current, she's iconic.

👑 AUTHORS 👑

Johan Larsson <johan@jolars.co> — the legend, the blueprint, the one who made this happen 🫶

ok that's the whole page bestie, you're officially tomat-pilled. now go start a session and be productive or whatever 💖

tomat 2.15.0, page tomat(1) — written by Johan Larsson <johan@jolars.co>, signed off with love, focus, and one (1) flawless pomodoro 🍓✨

📦 where this page comes from