pomodoro

Run Pomodoro timers with auto-completion and local JSON logging on macOS.

18|2|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/Onlyaguest/ViviStableSkills --skill pomodoro-onlyaguest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pomodoro
Source: https://github.com/Onlyaguest/ViviStableSkills/tree/main/pomodoro
Command: npx skills add https://github.com/Onlyaguest/ViviStableSkills --skill pomodoro-onlyaguest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

AI-powered Pomodoro timer that automates focus sessions, logs work locally, and notifies on completion to help users maintain productivity without manual tracking.

Core Features & Use Cases

  • Auto-completion after a set duration to sustain momentum.
  • Local JSON logging of sessions for review and dashboards.
  • macOS system notifications to keep you informed without interrupting workflow.
  • Optional Roam Research sync and live dashboard deployment for extended workflows.

Quick Start

Start a 25-minute session by running the pomodoro script with a task, e.g., cd pomodoro && ./bin/pomodoro.sh start "write code" 25.

Frequently Asked Questions about pomodoro

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate a Pomodoro timer with local logging on macOS?

You can automate a Pomodoro timer on macOS by running a shell script that starts focus sessions, auto-completes them after a set duration, and records session data into a local JSON log for later review.

Can I sync Pomodoro focus session logs with Roam Research?

Yes, Pomodoro focus session logs can be synced with Roam Research. The timer workflow stores sessions in a local JSON-backed log and optionally integrates with Roam Research for extended tracking.

How do I get macOS system notifications when a focus timer ends?

To get macOS system notifications when a focus timer ends, use an auto-completing Pomodoro timer script. It automatically triggers system notifications upon session completion without interrupting your workflow.

What is the best way to log daily Pomodoro sessions for a dashboard?

The best way to log daily Pomodoro sessions for a dashboard is using a CLI workflow that saves session records to a local JSON-backed log, which can then be deployed to a live dashboard.

Does the Pomodoro CLI workflow require any external dependencies?

No, the Pomodoro CLI workflow requires no external dependencies to run. It operates entirely using shell scripts and a local JSON log on your macOS system.

How do I start a 25-minute focus session from the macOS command line?

To start a 25-minute focus session from the macOS command line, execute the Pomodoro shell script with your task description and duration, such as `./bin/pomodoro.sh start "write code" 25`.