A macOS menu bar Pomodoro timer controllable via URL schemes for AI-driven focus management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pomoclaw
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pomoclaw using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is PomoClaw?
PomoClaw is a specialized macOS application that resides in the menu bar, providing a minimal yet powerful Pomodoro timer. This skill allows users to manage their focus intervals through simple URL schemes, making it an ideal companion for Openclaw Skills. By integrating this timer, developers can enable their AI agents to programmatically control work sessions, breaks, and configuration settings without manual intervention, fostering a more disciplined and automated workflow.
PomoClaw Use Cases
- Initiating a focus timer when an agent starts a complex development task.
- Pausing or resuming work sessions through voice or text commands within Openclaw Skills.
- Monitoring focus stats and automatically logging completed pomodoros.
- Customizing work and break durations based on the user's daily schedule.
How PomoClaw Works
- The AI agent executes a bash command via the Mac node to interact with the PomoClaw URL protocol.
- Commands like start, pause, or stop are sent directly to the application using the open command.
- The application updates its internal state and visual UI in the macOS menu bar immediately.
- When requested, the status command outputs the current timer data to a local JSON file in the user directory.
- Openclaw Skills can then read this file to provide real-time updates or feedback on the session progress.
PomoClaw Setup
Download the application from the official GitHub repository and move it to your Applications folder. Ensure the app is running as it operates as a menu bar item without a dock icon. To integrate with Openclaw Skills, use the following bash command structure:
bash -c "open 'pomoclaw://start?minutes=25'"
PomoClaw Data Schema & Taxonomy
The skill utilizes a JSON file located at ~/.pomoclaw/status.json to communicate state.
| Property | Type | Description |
|---|---|---|
| state | string | The current timer state: running, paused, or idle |
| mode | string | The active mode: work, break, break_ready, or idle |
| remaining | integer | Remaining time in seconds |
| total | integer | Total duration of the session in seconds |
| completedCount | integer | Number of pomodoros finished in the current session |
| startedAt | string | ISO8601 timestamp of when the session began |
PomoClaw Advanced Features
- Configurable alert sounds including options like Glass, Purr, and Sosumi.
- Automatic long break intervals triggered every fourth pomodoro completed.
- Flexible duration settings for work, short breaks, and long breaks via Openclaw Skills parameters.
- Webhook support for system events when focus sessions or breaks are finished.
SKILL.md
Loading
Related Openclaw Skills
System Information Reporter
A professional diagnostic tool that generates detailed system environment reports including CPU, memory, disk, and network status in timestamped Markdown files.
Redigg Research Agent
A specialized agent integration that connects to the Redigg platform to autonomously poll for, process, and submit scientific research tasks.
SunoMaker
SunoMaker is a professional-grade automation tool for generating AI music on headless Linux servers using virtual display technology and Gemini-powered captcha solving.
Gemini Nano Images
Create photorealistic AI images and complete Instagram posts using Google Gemini 2.0 Flash Experimental.
Gumroad Analytics
A privacy-focused tool for automating the collection and summarization of Gumroad sales and product performance data.
Resend Email
A professional email automation skill for sending transactional and notification messages using the Resend API within Openclaw Skills.
Featured*
