tomat-start(1)

🍅 start — tomat-start(1) 🍅

okay so bestie, welcome to the tomat-start(1) manual page for start. it's giving “new Pomodoro session, but make it organized” ✨

---

🌸 NAME 🌸

• start — start a new Pomodoro session, periodt 🍅💅

---

✨ SYNOPSIS ✨

start [-w|--work] [-b|--break] [-l|--long-break] [-s|--sessions] [-a|--auto-advance] [--sound-mode] [--volume] [-h|--help]

---

🦋 DESCRIPTION 🦋

okay so you're starting a brand-new Pomodoro timer session with the durations you specify. easy. iconic. 🔥

if you don't pass any options, it uses the defaults from the platform config file or the built-in defaults: 25min work, 5min break, 15min long break, and 4 sessions. no cap.

and listen: custom durations only apply to the current session. so don't expect them to stick around forever, bestie 😭💖

---

💅 OPTIONS 💅

• -w, --work <WORK> — duration of work sessions in minutes. if you don't specify it, it uses the value from the platform config file or the built-in default of 25 minutes. ⏳
• -b, --break <BREAK_TIME> — duration of short breaks in minutes. if you don't specify it, it uses the value from the platform config file or the built-in default of 5 minutes. 🌿
• -l, --long-break <LONG_BREAK> — duration of long breaks in minutes. long breaks happen after you complete the configured number of work sessions. if you don't specify it, it uses the value from the platform config file or the built-in default of 15 minutes. 🌙
• -s, --sessions <SESSIONS> — number of work/break cycles before taking a long break. if you don't specify it, it uses the value from the platform config file or the built-in default of 4 sessions. 🔁
• -a, --auto-advance <AUTO_ADVANCE> — control automatic phase transitions:
  • all — Auto-advance through all phases
  • none — Never auto-advance (pause at transitions)
  • to-break — Auto-advance from work to break only
  • to-work — Auto-advance from break to work only

if you don't specify it, it uses the value from the platform config file or the built-in default of 'none'. 👑

• --sound-mode <SOUND_MODE> — control sound notifications:
  • embedded — Use built-in audio files (default)
  • system-beep — Use system beep (terminal bell)
  • none — No sound notifications

if you don't specify it, it uses the value from the platform config file or the built-in default of 'embedded'. 🔊

• --volume <VOLUME> — set the audio volume for sound notifications, from 0.0 (silent) to 1.0 (maximum). values outside this range will be clamped. if you don't specify it, it uses the value from the platform config file or the built-in default of 0.5. 🎚️✨
• -h, --help — Print help (see a summary with '-h') 🫶

---

🌈 EXTRA 🌈

the examples, bestie — literally right here:

# Start with defaults
tomat start

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

# Auto-advance between phases
tomat start --auto-advance

---

okay that's a wrap! this whole page is the tomat-start(1) manual under General Commands Manual, and ngl the footer doesn't print a version or date, so I'm not gonna invent one — that would be giving fake info, and we don't do that here 💅🎀✨