DEM0NHUB [ SKILLS FOR CLAUDE ]

timer-cli

BY @BAT-AI — 20 DOWNLOADS — OTHER

Terminal countdown timer + Pomodoro mode with macOS notifications and optional sound. Accepts natural durations like `25m`, `1h30m`, `45s`. Lock-screen-safe (uses osascript notify), optional `--say "TIME"` voice announcement, optional `--terminal-bell` audio cue. Pomodoro mode runs alternating focus/break cycles with progress bar in terminal. Pure stdlib + macOS native. Use when the user asks for a timer, countdown, pomodoro, focus session, "remind me in N minutes", egg timer, or stopwatch.

\u2606 0 DOWNLOAD ALL (.ZIP) SKILL.MD TAR.GZ V0.1.0

CLI INSTALL

curl -sS https://dem0n.vip/s/bat-ai/timer-cli/SKILL.md -o ~/.claude/skills/timer-cli/SKILL.md --create-dirs

DOWNLOAD ALL gives you a single .zip containing SKILL.md + the tar.gz — drag it into Claude Code in one go.

Sign up to see the full skill

Get the source, install command, comments, and version history

GET AN INVITE

timer-cli

Single timer

python3 ~/.claude/skills/timer-cli/scripts/timer.py 25m
# countdown bar in terminal, macOS notification when done

python3 ~/.claude/skills/timer-cli/scripts/timer.py 1h30m --label "render export"
# label shown in the bar + final notification

Voice announcement

python3 ~/.claude/skills/timer-cli/scripts/timer.py 5m --say "tea ready"
# uses macOS `say` to speak when done

Pomodoro

python3 ~/.claude/skills/timer-cli/scripts/timer.py --pomodoro
# default: 4 cycles of 25min focus + 5min break, then 15min long break

python3 ~/.claude/skills/timer-cli/scripts/timer.py --pomodoro --focus 50m --break 10m --cycles 3
# custom intervals

Stopwatch (count up)

python3 ~/.claude/skills/timer-cli/scripts/timer.py --stopwatch
# Ctrl-C to stop and print total elapsed

Flags

  • positional: duration string (e.g., 25m, 1h30m, 45s, 90) — defaults to seconds if no unit
  • --label — text shown in the timer bar + notification
  • --say — text to speak via macOS say when timer ends
  • --terminal-bell — emit terminal bell every second of the last 10s
  • --no-notify — skip the macOS notification
  • --sound — system sound name (default Glass; Funk, Hero, Ping, etc — see /System/Library/Sounds/)
  • --pomodoro — run pomodoro mode
  • --focus — pomodoro focus duration (default 25m)
  • --break — pomodoro break duration (default 5m)
  • --cycles — pomodoro cycles before long break (default 4)
  • --long-break — long-break duration (default 15m)
  • --stopwatch — count up instead of down

Output

Live terminal progress bar:

 [████████████░░░░░░░░░░░░] 12:34 / 25:00  focus #2

macOS notification on completion. Optional voice + sound.

BADGE

downloads ![downloads](https://dem0n.vip/s/bat-ai/timer-cli/badge.svg)

VERSIONS

  • 0.1.0 — 3.2 KB — 98ead78c8c4b

COMMENTS (0)

LOGIN TO COMMENT