mcpField
T
time-tracking

time-tracking

github.com/steveclarke生産性36128 回インストール今日更新
リポジトリ

time-tracking について

time-trackingは、Toggl TrackまたはClockifyで作業時間を記録するコマンド型スキルです。共通スクリプトでタイマーを開始・停止・確認でき、1Passwordから取得した認証情報をキャッシュします。

主な機能

  1. 01Toggl TrackまたはClockifyで時間を記録
  2. 02タイマーの開始・停止・確認
  3. 03コマンドごとにプロバイダーを選択
  4. 04正確に照合するプロジェクト名を一覧表示
  5. 05APIトークンを24時間キャッシュ
  6. 06認証情報のキャッシュを消去

活用シーン

  1. 01プロジェクトの作業時間を記録
  2. 02実行中のタイマーを確認または停止
  3. 03Toggl TrackとClockifyを切り替え
  4. 04APIキー更新後の再認証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/steveclarke/dotfiles --skill time-tracking

インストール後、Claude Code で/time-trackingを入力して読み込まれたか確認します。

同梱ファイル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を使用します

注意事項

  • プロジェクト名は完全に一致する必要があります。利用可能な名前を一覧表示するには、プロジェクトを使用してください
  • 1Passwordを使用して認証します。
    • Toggl：op://Employee/Toggl/api key
    • Clockify：op://Employee/Clockify/Saved on app.clockify.me/apikey
  • トークンのキャッシュ：1Passwordのプロンプトが繰り返し表示されないよう、APIトークンは~/.local/state/steveos/time-tracking/に24時間キャッシュされます
  • 使用方法の詳細はスクリプト/トラック --helpを実行してください

キャッシュの管理

scripts/track cache:clear      # Clear token for current provider
scripts/track cache:clear:all  # Clear all cached tokens

1PasswordでAPIキーをローテーションした場合や、再認証が必要な場合に使用してください。

コメント

Markdown 対応