命令行番茄钟定时器

一个极简、跨平台的番茄工作法计时器,适用于开发者和深度工作者,轻量级、可配置且易于与自动化工具或AI代理集成。

  • by nuri428
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nuri428/mcp_Pomodoro

使用说明

番茄钟(CLI)

面向开发人员和深度工作从业者的最小跨平台番茄钟。
轻量级、可配置,旨在轻松与自动化工具或AI代理集成。



特性

  • 可定制的焦点、休息和长休息时间
  • macOS、Linux和Windows上的桌面通知
  • 可选的config.json支持
  • macOS/Linux的零外部依赖
  • 非常适合终端工作流程(tmux、VSCode、SSH、MCP)

安装

克隆存储库:

git clone https://github.com/nuri428/pomodoro-cli.git
cd pomodoro-cli

Windows通知支持:

pip install -r requirements.txt

用法

默认值(25分钟聚焦/5分钟休息)

python3 cli.py

自定义持续时间

python3 cli.py --focus 50 --break 10

快速测试

python3 cli.py --focus 1 --break 1

使用config.json

配置示例:

{
    "focus_time": 25,
    "break_time": 5,
    "long_break_time": 15,
    "cycles": 4
}

如果此文件存在,CLI将自动加载它。


项目结构

pomodoro/        # Core timer logic
cli.py           # CLI entry point
config.json      # Optional user config
README.md

路线图

  • GUI版本
  • macOS菜单栏计时器
  • Windows托盘版本
  • MCP(模型上下文协议)集成
  • 谷歌日历同步
  • 基于Webhook的自动化

许可证

MIT许可证。