pomodoro

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

18|2|Updated Mar 18, 2026

Search Tags:#automation #productivity #logging #macos #focus #pomodoro #timer

Ready to run

npx skills add https://github.com/Onlyaguest/ViviStableSkills --skill pomodoro-onlyaguest

💬 Prompt for ChatGPT / Claude Chat▼

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`.