PomoClaw 🍅

一个极简的番茄钟计时器，位于macOS菜单栏。支持通过URL方案控制，完美适配OpenClaw集成。

GitHub： https://github.com/vkozlovskyi/PomoClaw
下载： https://github.com/vkozlovskyi/PomoClaw/releases/latest

命令

通过Mac节点上的nodes.run使用bash -c open pomoclaw://...运行：

pomoclaw://start # 使用默认时长（25分钟）启动计时器
pomoclaw://start?minutes=N # 启动N分钟计时器（1-99）
pomoclaw://pause # 暂停/继续切换
pomoclaw://stop # 停止并重置
pomoclaw://status # 将状态写入~/.pomoclaw/status.json
pomoclaw://break?minutes=N # 启动N分钟休息计时器
pomoclaw://skip # 跳过当前休息

配置

所有配置通过单个pomoclaw://config命令完成：

pomoclaw://config?workMinutes=25 # 设置默认工作时长
pomoclaw://config?shortBreak=5 # 设置短休息时长
pomoclaw://config?longBreak=15 # 设置长休息时长
pomoclaw://config?sound=Glass # 设置工作完成提示音
pomoclaw://config?breakSound=Purr # 设置休息完成提示音
pomoclaw://config?launchAtLogin=true # 启用登录时启动
pomoclaw://config?count=0 # 设置已完成番茄钟数量

多个参数可组合使用：

pomoclaw://config?workMinutes=25&shortBreak=5&longBreak=15

有效提示音

默认设置

• - 工作：25分钟，短休息：5分钟，长休息：15分钟（每第4个番茄钟）
• 工作提示音：Glass，休息提示音：Purr

检查状态

执行pomoclaw://status后，读取文件：

cat ~/.pomoclaw/status.json

返回：{state: running|paused|idle, remaining: <秒数>, total: <秒数>, startedAt: , completedCount: N, mode: work|break|break_ready|idle}

Webhooks

• - 工作完成：🍅 番茄钟完成！N分钟专注时段结束。
• 休息完成：☕ 休息结束！N分钟休息完成。

工作完成时：

• - 向用户确认已完成时段
• 休息计时器将自动显示（绿色弧线）。用户点击即可开始。
• 每第4个番茄钟后为长休息（15分钟），其余为短休息（5分钟）。

注意事项

• - 计时器范围：1–99分钟
• 应用必须在Mac上运行才能执行命令
• 无程序坞图标——仅存在于菜单栏（LSUIElement）
• 通过nodes.run使用bash -c open pomoclaw://...（比带URL编码的数组格式更可靠）
• 应用重启后不恢复休息状态——仅在工作结束后有意义