Claudoro: Claude Code 的番茄钟工具
Claudoro: Claude Code 的番茄钟工具
Claudoro 将时间管理直接集成到 Claude Code 终端中
Claudoro 是一个专为 Claude Code 环境设计的番茄钟工具，它将实时倒计时和周期追踪器直接嵌入到终端的状态栏中。通过将计时器放置在开发者目光所及之处，它消除了对外部应用、浏览器标签页或手机通知的需求，而这些通常会导致上下文切换并破坏深度工作流。
安装与设置
Claudoro 需要 Node.js 版本 22 或更高。它可以通过 npm 全局安装，也可以为了开发目的从源码安装。
安装步骤：
- 通过 npm 安装：
npm install -g claudoro - 初始化： 运行
pomo setup将该工具接入 Claude Code。此过程会创建/pomo命令文件，并将必要的statusLine配置合并到settings.json文件中（在创建备份之后）。
设置完成后，用户可以通过在新的 Claude Code 会话中运行 /pomo start 来启动计时器。
核心功能与用法
Claudoro 作为一个 CLI 工具运行，为计时器状态提供单一事实来源，随后将其反映在 Claude Code 的状态栏中。它不需要模型往返交互，这意味着它不会消耗 API tokens。
计时器控制
用户可以使用以下命令来管理他们的专注时段：
/pomo start [mins]: 启动一个专注块。用户可以使用标志来覆盖默认设置：-w(work),-s(short break),-l(long break), 和-f(frequency of long breaks)。/pomo pause | resume | stop: 控制当前计时器状态。/pomo skip: 进入番茄钟周期的下一个阶段。/pomo reset: 重启当前阶段。/pomo extend [N]: 为当前阶段增加 N 分钟。
状态栏视图
Claudoro 提供三种可通过 /pomo view <mode> 切换的可视化模式：
- Minimal: 仅显示计时器和进度条 (
🍅 22:47 ▕████████░░▏)。 - Classic (Default): 添加周期圆点以追踪向长休息的进度 (
🍅 22:47 ▕████████░░▏ ●●○○)。 - Full: 在状态栏中添加当前任务标签 (
🍅 22:47 ▕████████░░▏ ●●○○ write tests)。
过渡模式
为了适应不同的工作风格，Claudoro 通过 /pomo mode <mode> 提供三种过渡行为：
- Auto (Default): 在专注和休息阶段之间自动切换。
- Balanced: 自动开始休息，但等待手动输入以开始下一个专注块，以避免浪费专注时间。
- Manual: 需要手动推进所有阶段的转换，非常适合深度工作流。
数据管理与隐私
Claudoro 遵循本地优先架构。所有数据都存储在用户机器的 XDG state 目录中，无需网络连接、账户或遥测。
- 日志记录： 完成的专注块被保存为每日 JSONL 日志中的不可变记录。所有统计数据都源自这些日志，而不是存储为计数器，这确保了
pomo undo命令可以移除记录而不会导致数据不同步。 - 分析：
pomo stats命令提供基于终端的分析，包括连续达标记录 (streaks) 和专注热力图。运行pomo stats --web会生成一个用于可视化分析的自包含 HTML 仪表板。 - 隐私： 生成的 HTML 仪表板存储在本地
~/.local/state/claudoro/dashboard.html，且绝不会上传到服务器。
技术架构与防护机制
系统设计
pomo CLI 作为中央控制器。状态栏和 /pomo 命令是与 CLI 通信的轻量级接口。一个独立的、分离的进程处理警报（声音和 OS 通知），以确保即使在终端会话关闭时也能触发。
放弃保护机制
为了防止计时器被意外遗留运行而导致统计数据偏差，Claudoro 实现了放弃保护机制。如果一个时段运行时间显著超过其计划时长（默认超时 30 分钟），该工具仅将计时器计入专注时长直到达到阈值，并在日志中将该记录标记为 abandoned。
社区洞察
虽然该工具因其与现有工作流的集成而受到称赞，但一些用户指出，在同时管理多个 AI agent 时，维持“深度工作”存在挑战。一位用户提到：
"如果你遵循 Cal Newport 的规则，看着多个 agent 在工作，这就不再是 25 分钟的‘深度工作’番茄钟了。"
其他用户强调了集成式小工具相对于独立生产力应用的价值，指出减少打开单独应用的摩擦力使得系统更有可能被使用。