mcpField
T
time-tracking

time-tracking

github.com/steveclarke生产力36128 次安装今天更新
代码仓库

关于 time-tracking

time-tracking 是用于通过命令记录工时的技能,支持 Toggl Track 和 Clockify。它用同一脚本启动、停止和查看计时器,并通过 1Password 获取凭据后缓存令牌。

主要功能

  1. 01使用 Toggl Track 或 Clockify 记录时间
  2. 02启动、停止和查看计时器
  3. 03按命令选择服务提供方
  4. 04列出项目名称以便精确匹配
  5. 05缓存 API 令牌 24 小时
  6. 06清除缓存凭据

适用场景

  1. 01记录项目耗时
  2. 02查看或停止正在运行的计时器
  3. 03在 Toggl Track 和 Clockify 之间切换
  4. 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
  • 令牌缓存: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