| name | c-timer |
| description | Timers, alarms, and pomodoro — set countdowns with native notifications. |
| tags | ["timer","alarm","pomodoro","countdown","reminder"] |
Timer — Countdowns & Pomodoro
Set timers and get notified via native macOS notifications. Uses terminal-notifier and background sleep.
Commands
(sleep 300 && terminal-notifier -title "Timer" -message "5 minutes is up!" -sound default) &
(sleep 1800 && terminal-notifier -title "Timer" -message "Break time!" -sound Glass) &
(sleep 1500 && terminal-notifier -title "Pomodoro" -message "Time for a break!" -sound Purr) &
(sleep 60 && say "One minute timer done" && terminal-notifier -title "Timer" -message "1 minute" -sound default) &
Time Conversions
| Duration | Seconds |
|---|
| 1 minute | 60 |
| 5 minutes | 300 |
| 10 minutes | 600 |
| 15 minutes | 900 |
| 25 minutes | 1500 |
| 30 minutes | 1800 |
| 1 hour | 3600 |
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:
- Start 25-minute work timer
- Notify when work session ends
- Start 5-minute break timer
- Notify when break ends
- 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