c-timer

star 149

Timers, alarms, and pomodoro — set countdowns with native notifications.

daxaur By daxaur schedule Updated 3/1/2026

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

# 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

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:

  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
Install via CLI
npx skills add https://github.com/daxaur/openpaw --skill c-timer
Repository Details
star Stars 149
call_split Forks 6
navigation Branch main
article Path SKILL.md
More from Creator