█████  ███  █    █  ███  █████  █    █
█   █ █   █ █    █ █   █ █      █    █
█████ █   █ █ ██ █ █   █ █████  ██████
█     █   █ █    █ █   █     █  █    █
█      ███  █    █  ███  █████  █    █

  █████  ███  █    █  ███  █████  █    █     ← gradient title
  █   █ █   █ █    █ █   █ █      █    █
  █████ █   █ █ ██ █ █   █ █████  ██████
  █     █   █ █    █ █   █     █  █    █
  █      ███  █    █  ███  █████  █    █
  ────────────────────────────────────────────────────────────

    What would you like to do?

    ❯ Start a new pomodoro
      View today's pomodoros
      Settings
      Exit

    [↑↓] navigate   [enter] select   [q] quit

• Fullscreen TUI — clean ANSI interface, no clutter
• Task history — navigate previous task names with ↑ ↓
• Automatic breaks — short break every pomodoro, long break every 4th
• Progress bar — visual countdown with a live fill bar
• macOS notifications — via terminal-notifier or osascript fallback
• 15 notification sounds — preview them live in the settings screen
• Persistent log — every session saved as JSONL, queryable from the CLI
• Zero config needed — sane defaults, everything adjustable in-app

git clone https://github.com/bicccio/pomosh.git
cd pomosh
npm install && npm run build
npm link          # makes `pomosh` available system-wide

For richer notifications (optional):

brew install terminal-notifier

pomosh                        # open the interactive menu
pomosh "fix the login bug"    # skip the menu, start immediately

Menu & input

During a pomodoro

After a pomodoro

Accessible from the main menu. Changes are saved automatically to ~/.pomosh/pomosh.cfg.

Every completed pomodoro is appended to ~/.pomosh/pomos/pomosh.jsonl:

{"date":"2026-03-19","time":"10:30","duration_min":25,"task":"fix the login bug"}

Query it directly:

pomosh -l               # today
pomosh -L 20260315      # specific date

npm run dev     # run with tsx (no build step needed)
npm run build   # compile to dist/