名称： toggl
描述： 通过 toggl CLI 使用 Toggl 进行时间追踪。当用户想要开始/停止时间追踪、查看当前计时器、查看今日或周度报告、列出近期条目或管理时间条目时触发。触发词包括："toggl"、"time tracking"、"timer"、"track time"、"what am I working on"、"log time"、"timesheet"。

Toggl 时间追踪

使用 toggl CLI (@beauraines/toggl-cli) 集成 Toggl Track。

前提条件

安装 CLI：

npm install -g @beauraines/toggl-cli

配置认证（创建 ~/.toggl-cli.json）：

{
  "api_token": "你的Toggl API令牌",
  "default_workspace_id": "你的工作区ID",
  "timezone": "你的/时区"
}

获取 API 令牌：https://track.toggl.com/profile
从 Toggl URL 获取工作区 ID：https://track.toggl.com/{workspace_id}/...

设置文件权限：chmod 600 ~/.toggl-cli.json

命令

状态

toggl now                    # 显示正在运行的计时器
toggl me                     # 显示用户信息

开始/停止

toggl start                  # 开始计时（交互式）
toggl start -d "任务名称"   # 指定描述开始
toggl start -d "任务" -p "项目"  # 指定项目和描述开始
toggl stop                   # 停止当前计时器

继续之前的条目

toggl continue               # 重启最近的条目
toggl continue "关键词"     # 重启匹配关键词的条目

报告

toggl today                  # 今日按项目统计的时间
toggl week                   # 周度按天汇总

列出条目

toggl ls                     # 最近 14 天
toggl ls -d 7                # 最近 7 天
toggl ls --today             # 仅今天
toggl ls "搜索词"       # 搜索条目

添加已完成的条目

toggl add "9:00AM" "10:30AM" "会议记录"

编辑当前条目

toggl edit -s "10:00AM"      # 更改开始时间
toggl edit -d "新描述"     # 更改描述
toggl edit -p "项目"      # 更改项目

删除

toggl rm <id>                # 根据 ID 删除条目

项目管理

toggl project ls             # 列出项目

其他

toggl web                    # 在浏览器中打开 Toggl
toggl create-config          # 生成配置模板

注意事项

• 时间格式必须能被 dayjs 解析（例如：4:50PM、12:00 AM、9:00）
• 配置文件：~/.toggl-cli.json
• 环境变量会覆盖配置：TOGGL_API_TOKEN、TOGGL_DEFAULT_WORKSPACE_ID、TOGGL_TIMEZONE