Claudoro: Claude Code 專用的番茄鐘計時器

Claudoro: Claude Code 專用的番茄鐘計時器

Claudoro 將時間管理直接整合至 Claude Code 終端機中

Claudoro 是一款專為 Claude Code 環境設計的番茄鐘計時器，直接將即時倒數和週期追蹤器嵌入到終端機的狀態列中。透過將計時器放置在開發者視線原本就集中的地方，它消除了對外部應用程式、瀏覽器分頁或手機通知的需求，而這些通常會導致情境切換並中斷深度工作流。

安裝與設定

Claudoro 需要 Node.js 版本 22 或更高版本。可以透過 npm 全域安裝，或為了開發目的從原始碼安裝。

安裝步驟：

  1. 透過 npm 安裝： npm install -g claudoro
  2. 初始化： 執行 pomo setup 將工具整合至 Claude Code。此過程會建立 /pomo 指令檔案，並將必要的 statusLine 設定合併到 settings.json 檔案中（在建立備份之後）。

設定完成後，使用者可以透過執行 /pomo start 在新的 Claude Code 工作階段中啟動計時器。

核心功能與用法

Claudoro 作為一個 CLI 工具運作，為計時器狀態提供單一事實來源，隨後反映在 Claude Code 的狀態列中。它不需要進行模型往返，這意味著它不會消耗 API token。

計時器控制

使用者可以使用以下指令來管理他們的專注時段：

  • /pomo start [mins]: 啟動一個專注區塊。使用者可以使用 flag 使用來覆蓋預設值：-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 通知），以確保即使在終端機工作階段關閉時，警報仍能觸發。

拋棄防護 (Abandonment Guard)

為了防止計時器意外持續運行時導致統計數據偏差，Claudoro 實作了拋棄防護機制。如果一個區塊運行時間顯著超過其計畫時長（預設為 30 分鐘超時），工具會僅將專注時間計入至該閾值，並在日誌中將該記錄標記為 abandoned。

社群洞察

雖然該工具因其與現有工作流的整合而受到讚譽，但一些使用者指出，在同時管理多個 AI agent 時，維持「深度工作」的挑戰。一位使用者提到：

"如果妳正在遵循 Cal Newport 的規則，監督多個 agent 正在進行他們的工作，這就不再是 25 分鐘的『深度工作』番茄鐘了。"

其他使用者強調了小型、整合式工具相對於獨立生產力應用程式的價值，指出減少開啟另一個應用程式的摩擦力，會使系統更有可能被使用。

Sources