pomo：终端番茄钟计时器

项目简介

pomo 是一个运行在终端里的番茄钟，使用 Go 和 Bubble Tea 构建。它提供 ASCII 艺术风格的计时器、实时进度条、跨平台桌面通知，以及用 pomo stats 查看的生产力统计。

主要功能

• 工作与休息会话，支持带长休息的番茄循环
• 会话结束后可链式进入下一段，并可要求确认
• 实时进度条可视化
• 会话中可用键盘调整时长、暂停/恢复、跳过
• 跨平台桌面通知
• 会话结束时执行自定义命令（例如播放提示音）
• pomo stats 统计：工作/休息时长比例、近 7 天每日工作时长柱状图、4 个月 GitHub 风格热力图
• 计时器支持 mono12、rebel、ansi、ansiShadow 四种 ASCII 字体与自定义颜色

热力图图标需要安装 Nerd Font。

安装与使用

Homebrew（macOS）：

brew install --cask bahaaio/pomo/pomo

Winget（Windows）：

winget install Bahaaio.pomo

Go：

go install github.com/Bahaaio/pomo@latest

也可以从 releases 页面 下载预编译二进制，或用 Nix 安装、从源码构建。

常用命令：

pomo                    # 工作会话
pomo 45m 15m            # 45 分钟工作 + 15 分钟休息
pomo -t "write report"  # 带自定义标题的工作会话
pomo break 10m          # 10 分钟休息
pomo stats              # 查看统计

配置文件

配置文件查找顺序：当前目录的 pomo.yaml → 系统配置目录（Linux/macOS 为 ~/.config/pomo/pomo.yaml，Windows 为 %APPDATA%\pomo\pomo.yaml）→ 内置默认值。

onSessionEnd: "ask" # ask | start | quit
asciiArt:
  enabled: true
  font: ansiShadow
  color: "#5A56E0"
work:
  duration: 25m
  notification:
    enabled: true
break:
  duration: 5m
  then:
    - [spd-say, "Back to work!"]
longBreak:
  enabled: true
  after: 4
  duration: 15m

快捷键

按键	作用
↑ / k	增加 1 分钟
Space	暂停/继续
← / h	重置为初始时长
s	跳到下一会话
q / Ctrl+C	退出

注意事项

• 桌面通知的实际样式因操作系统和桌面环境而异。
• then 中的自定义命令有 5 秒超时，开始下一会话时会被自动取消。
• 热力图需要 Nerd Font 才能正确显示图标。
• 项目使用 MIT 许可证。

---

本作品整理自 GitHub 开源项目 Bahaaio/pomo，原作者 @Bahaaio，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。