用途:本技能用于通过命令行工具 toggl CLI(@beauraines/toggl-cli)与 Toggl Track 集成,在用户需要时执行时间跟踪相关操作。
主要能力:
- 状态查询:查看当前正在运行的计时器、显示用户信息。
- 开始/停止计时:可交互式启动计时器,也可指定任务描述与项目启动,随时停止当前计时。
- 继续之前的记录:重启最近一条时间条目,或按关键词匹配重启条目。
- 报表:查看今日按项目统计的时间、按天汇总的每周报告。
- 列出条目:列出最近 14 天、最近 7 天、仅今日或按搜索词匹配的时间条目。
- 添加已完成条目:以指定开始与结束时间及描述补充记录。
- 编辑当前计时:修改开始时间、描述或所属项目。
- 删除条目:按 ID 移除条目。
- 项目:列出项目。
- 其他:在浏览器中打开 Toggl,生成配置模板。
使用方式:
- 安装 CLI:npm install -g @beauraines/toggl-cli
- 配置认证:创建 ~/.toggl-cli.json,包含 api_token、default_workspace_id、timezone 三个字段。API 令牌可在 Toggl 个人资料页获取,工作区 ID 来自 Toggl 的 URL 路径。
- 设置权限:chmod 600 ~/.toggl-cli.json
- 使用对应命令执行操作,例如 toggl now、toggl start -d "Task name"、toggl stop、toggl today、toggl week、toggl ls、toggl add、toggl edit、toggl rm、toggl project ls 等。
适用场景:需要在命令行中快速进行 Toggl 时间跟踪、查询报表或管理时间条目的工作流程。
限制与注意:时间格式必须能被 dayjs 解析(例如 4:50PM、12:00 AM、9:00)。配置文件位于 ~/.toggl-cli.json;环境变量 TOGGL_API_TOKEN、TOGGL_DEFAULT_WORKSPACE_ID、TOGGL_TIMEZONE 会覆盖配置文件。其余细节暂未提供。