Menu
AI-powered Pomodoro timer with auto-completion, local logging, and macOS notifications.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Open local review artifacts in Xiaoer Omia when users ask to open, preview, inspect, or review a file.
Run a measured improvement loop for a skill by defining a yes/no checklist, capturing a baseline, scoring candidate outputs, and logging each iteration's keep/revert decision. Use when a skill works inconsistently and you want evidence-driven iteration instead of random prompt edits.
Build a static HTML report site from CSV, JSON, Markdown, or HTML inputs. Use when the user wants to turn existing data into a human-readable site, generate a data showcase page, create a static report website, or optionally publish the built site.
Add offline multilingual support to static HTML, small web projects, or reports by extracting text into tokens, maintaining language dictionaries, applying translated outputs, and optionally embedding a local language switcher. Use when the user asks for bilingual support, tokenizing Chinese copy, offline language switching, or i18n for reports and lightweight sites.
Unified entrypoint for Obsidian note operations such as cleanup, merge, lint/fix, meeting archive, daily rollover, and docs sync. Use when the user wants one command surface over an existing notes-tools repo instead of calling many atomic scripts by hand.
Test, tune, and regression-check LLM system prompts with a golden dataset. Use when the user wants to optimize a prompt, run prompt regression tests, manage `cases.yaml`, compare expected vs actual outputs, or follow a TDD workflow for prompts.
| name | pomodoro |
| description | AI-powered Pomodoro timer with auto-completion, local logging, and macOS notifications. |
| version | 1.1.0 |
| author | Vivi |
| tags | ["productivity","timer","focus"] |
| platforms | ["macos"] |
| dependencies | ["python3","bash"] |
Manages focus sessions with timer, auto-completion, JSON logging, and optional Roam/dashboard sync.
cd pomodoro && chmod +x bin/*.sh
# Start 25-minute session
./bin/pomodoro.sh start "write code" 25
# Complete early with note
./bin/pomodoro.sh done "finished ahead of schedule"
| Command | Description | Example |
|---|---|---|
start <task> [min] | Start new pomodoro | start "coding" 25 |
done [note] | Complete current session | done "all tests pass" |
interrupt [note] | Stop current session | interrupt "urgent call" |
status | Show current session | status |
today | View today's sessions | today |
All configuration is via environment variables (all optional):
| Variable | Description | Default |
|---|---|---|
POMODORO_DATA_DIR | Session data directory | <skill>/data/ |
ROAM_GRAPH | Roam Research graph name for sync | (disabled) |
POMODORO_SITE_DIR | Dashboard HTML output directory | (required for dashboard) |
POMODORO_GIT_DIR | Dashboard git repo root | (required for dashboard) |
{
"sessions": [
{
"id": "20260324-211211",
"date": "2026-03-24",
"startTime": "21:12",
"endTime": "21:35",
"duration": 25,
"actualDuration": 23,
"task": "write code",
"status": "complete",
"note": "finished",
"energy": -15
}
]
}
pomodoro/
├── bin/
│ ├── pomodoro.sh # Main timer script
│ └── dashboard.sh # Dashboard deployment (optional)
├── assets/
│ └── index.html # Dashboard template
├── examples/
│ └── integration.sh # Integration examples
├── data/ # Auto-created on first run
│ ├── current.json # Running session state
│ └── sessions.json # All sessions log
├── SKILL.md
└── README.md
Deploy a live stats page:
export POMODORO_SITE_DIR=~/my-site/pomodoro
export POMODORO_GIT_DIR=~/my-site
./bin/dashboard.sh
The dashboard (assets/index.html) reads sessions.json and shows today's count, total time, and recent sessions.
Notifications not showing? Check: System Preferences > Notifications > Terminal > Allow.
Auto-completion not working?
Verify the background process: ps aux | grep pomodoro.sh
Roam sync not working?
Ensure ROAM_GRAPH is set and bb (Babashka) is installed: brew install borkdude/brew/babashka