核心用法
PomoClaw 是一款极简的 macOS 菜单栏番茄钟工具，通过 pomoclaw:// URL Scheme 实现外部控制，专为自动化工作流设计。用户可通过命令行或自动化工具（如 OpenClaw）远程启动/暂停/停止计时器、自定义工作时长（1-99分钟）、管理休息周期，并查询实时状态。状态信息持久化至 ~/.pomoclaw/status.json，支持 webhook 回调在专注完成或休息结束时触发系统通知。
显著优点
- 零界面干扰：无 Dock 图标，纯菜单栏存在（LSUIElement），保持桌面整洁
- 深度自动化：URL Scheme 设计天然支持脚本化、远程节点控制及工作流集成
- 灵活配置：支持自定义工作/短休/长休时长、15种系统提示音、开机自启等完整参数
- 状态可观测：JSON 格式状态文件便于第三方工具读取，实现跨应用联动
- 智能休息管理：每4个番茄钟后自动切换15分钟长休息，平衡效率与恢复
潜在局限
- 平台绑定：仅支持 macOS，Windows/Linux 用户无法使用
- 前置依赖：应用必须保持运行状态，命令才会生效；无后台守护机制
- 状态持久化缺陷：休息状态在应用重启后不恢复，仅适用于会话内连续使用
- 网络无关性：无云同步、跨设备协同或团队功能，纯本地工具
- 生态小众：GitHub Stars 有限，长期维护依赖个人开发者
适合人群
- 追求极简、厌恶复杂番茄钟界面的 macOS 深度用户
- 已搭建自动化工作流（如 OpenClaw、Hammerspoon、Alfred）的效率工具爱好者
- 需要将专注状态与外部系统（如日志记录、智能灯光）联动的开发者
- 偏好菜单栏工具而非独立窗口或浏览器插件的用户
常规风险
- 命令注入防范：虽通过 URL Scheme 隔离，但构造
nodes.run命令时仍需注意参数校验，避免路径遍历 - 状态文件竞争：多进程同时读写
status.json可能导致状态不一致，建议配合文件锁使用 - 权限边界：
launchAtLogin配置需用户手动授权系统登录项权限，首次设置可能失败静默 - 时间漂移：系统睡眠后计时器行为依赖 macOS 唤醒机制，极端情况下可能出现剩余时间不精确