Timewarrior

產品說明

Timewarrior（簡稱 timew）是一款專為命令列愛好者設計的時間追蹤工具。它由開發知名待辦事項工具 Taskwarrior 的團隊（Gothenburg Bit Factory）打造，延續了「極簡、高效、無干擾」的設計哲學。

與圖形化介面的時間追蹤軟體不同，Timewarrior 讓你在終端機中透過簡單的指令即可開始或結束計時。它具備強大的後台邏輯，能自動處理時間重疊、忽略午休時間，並支援以標籤（Tags）來分類專案。其資料以 JSON 格式儲存，方便開發者進行二次開發或數據分析。

核心特色：

• 極致輕量：無常駐背景程序，僅在執行指令時運作，資源占用極低。
• 無干擾介面：不需要切換視窗，手指不離鍵盤即可完成時間紀錄。
• 靈活的標籤系統：支援多重標籤（例如 timew start ProjectA Coding FeatureX），便於日後生成精細的報表。
• 視覺化報表：內建 summary、day、week 等指令，能直接在終端機繪製出色彩豐富的時間軸圖表。
• 智慧除錯：若忘記停止計時，支援事後修正或自動剔除閒置時段（需設定）。

安裝指南

Timewarrior 支援主流的 Unix-like 系統，Windows 使用者建議透過 WSL 或 Scoop 安裝。

macOS (Homebrew)

brew install timewarrior

Linux (Ubuntu/Debian)

sudo apt install timewarrior

Linux (Arch Linux)

sudo pacman -S timew

Windows (Scoop)

scoop install timewarrior

使用教學

1. 基礎計時

Timewarrior 的操作邏輯非常直觀，就像使用碼表一樣。

• 開始工作：
  輸入 timew start 加上你的任務名稱或標籤。

  timew start Coding ProjectA
  

  (系統會自動建立 "Coding" 與 "ProjectA" 這兩個標籤並開始計時)

• 停止工作：

  timew stop
  

• 切換任務：
  你不需要先停止再開始，直接輸入新的 start 指令，Timewarrior 會自動停止上一個任務並開始新任務。

  timew start Meeting HR
  

2. 查看報表

紀錄時間的目的是為了分析。Timewarrior 提供多種視角的報表。

• 查看目前狀態與當日摘要：

  timew summary
  

• 查看本週工時：

  timew week
  

3. 進階技巧：事後補錄與修正

忘記按開始或結束是常有的事，Timewarrior 對此非常寬容。

• 事後補錄 (Backfill)：
  告訴它你「一小時前」做了什麼：

  timew track :1h ago "Reading Docs"
  

• 繼續上一個任務：
  休息回來後，想繼續剛剛的工作：

  timew continue
  

• 排除休息時間：
  你可以設定自動排除中午 12:00 到 13:00 的時間，避免午休被算入工時（需編輯設定檔）。

小撇步：搭配 Taskwarrior 使用效果更佳！它們可以透過掛鉤（Hook）連動，當你開始一個 Taskwarrior 任務時，Timewarrior 會自動開始計時。