关于 time-tracking
time-tracking 是用于通过命令记录工时的技能,支持 Toggl Track 和 Clockify。它用同一脚本启动、停止和查看计时器,并通过 1Password 获取凭据后缓存令牌。
主要功能
- 01使用 Toggl Track 或 Clockify 记录时间
- 02启动、停止和查看计时器
- 03按命令选择服务提供方
- 04列出项目名称以便精确匹配
- 05缓存 API 令牌 24 小时
- 06清除缓存凭据
适用场景
- 01记录项目耗时
- 02查看或停止正在运行的计时器
- 03在 Toggl Track 和 Clockify 之间切换
- 04轮换 API 密钥后重新认证
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ steveclarke/ dotfiles --skill time-tracking安装后在 Claude Code 中输入/time-tracking确认已加载。
附带文件scripts/track
详细介绍
时间跟踪
使用 scripts/track 执行所有时间跟踪操作。支持 Toggl(默认)和 Clockify。
命令
# Real-time tracking (default: Toggl)
scripts/track start "Task description" -p "Project Name"
scripts/track stop
scripts/track current
# Use Clockify instead
scripts/track start "Task description" -p "Project Name" -P clockify
scripts/track current -P clockify
# Manual entries (past dates)
scripts/track create "Description" -p "Project" -s "YYYY-MM-DD HH:MM" -e "YYYY-MM-DD HH:MM"
scripts/track create "Description" -p "Project" -s "..." -e "..." -t "tag1,tag2" # with tags
# Management
scripts/track delete <entry-id>
scripts/track entries --days 7
scripts/track projects
scripts/track me
# Projects and tags (Toggl only)
scripts/track project:create "Project Name"
scripts/track project:create "Project Name" -b # billable
scripts/track project:create "Project Name" --private # private project
scripts/track tags
服务提供方选择
-P toggl(默认)- 使用 Toggl Track-P clockify- 使用 Clockify
说明
- 项目名称必须完全匹配 - 使用
projects列出可用名称 - 通过 1Password 进行身份验证:
- Toggl:
op://Employee/Toggl/api key - Clockify:
op://Employee/Clockify/Saved on app.clockify.me/apikey
- Toggl:
- 令牌缓存:API 令牌会缓存到
~/.local/state/steveos/time-tracking/,有效期为 24 小时,以避免反复提示输入 1Password - 运行
scripts/track --help查看完整用法
缓存管理
scripts/track cache:clear # Clear token for current provider
scripts/track cache:clear:all # Clear all cached tokens
如果你在 1Password 中轮换了 API 密钥,或需要重新进行身份验证,请使用这些命令。
评论
支持 Markdown