Timer — Countdowns & Pomodoro

Set timers and get notified via native macOS notifications. Uses terminal-notifier and background sleep.

Commands

# Simple timer (runs in background)
(sleep 300 && terminal-notifier -title "Timer" -message "5 minutes is up!" -sound default) &

# Timer with custom message
(sleep 1800 && terminal-notifier -title "Timer" -message "Break time!" -sound Glass) &

# Pomodoro (25 min work, 5 min break)
(sleep 1500 && terminal-notifier -title "Pomodoro" -message "Time for a break!" -sound Purr) &

# Quick reminder (with say for audio)
(sleep 60 && say "One minute timer done" && terminal-notifier -title "Timer" -message "1 minute" -sound default) &

Time Conversions

Notification Sounds

Available: default, Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink

Pomodoro Workflow

When the user asks for pomodoro:

1. Start 25-minute work timer
2. Notify when work session ends
3. Start 5-minute break timer
4. Notify when break ends
5. Repeat (ask user after 4 cycles if they want a 15-min long break)

Guidelines

• Always confirm the timer was set with the exact duration
• Use & to run in background so the terminal stays responsive
• Default sound: default for timers, Purr for pomodoro
• If terminal-notifier is not installed, fall back to say command
• For "remind me in X minutes", treat as a timer
• Convert natural language: "half hour" = 1800s, "quarter hour" = 900s