mcpField
T
time-tracking

time-tracking

github.com/steveclarkeProductivity36128 installsUpdated today
Repository

About time-tracking

time-tracking is a command-based skill for recording work time with Toggl Track or Clockify. It uses a shared script for starting, stopping, and checking timers, with cached credentials retrieved through 1Password.

Key features

  1. 01Track time with Toggl Track or Clockify
  2. 02Start, stop, and check timers
  3. 03Select a provider per command
  4. 04List project names for exact matching
  5. 05Cache API tokens for 24 hours
  6. 06Clear cached credentials

Use cases

  1. 01Recording time spent on a project
  2. 02Checking or stopping an active timer
  3. 03Switching between Toggl Track and Clockify
  4. 04Re-authenticating after rotating an API key

Install

Copy the command and run it in a terminal.

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

After installing, type/time-trackingin Claude Code to confirm it loaded.

Bundled filesscripts/track

Details

From the project README

Time Tracking

Use scripts/track for all time tracking operations. Supports both Toggl (default) and Clockify.

Commands

# 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

Provider Selection

  • -P toggl (default) - Use Toggl Track
  • -P clockify - Use Clockify

Notes

  • Project names must match exactly - use projects to list available names
  • Authentication via 1Password:
    • Toggl: op://Employee/Toggl/api key
    • Clockify: op://Employee/Clockify/Saved on app.clockify.me/apikey
  • Token caching: API tokens are cached in ~/.local/state/steveos/time-tracking/ for 24 hours to avoid repeated 1Password prompts
  • Run scripts/track --help for full usage

Cache Management

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

Use these if you rotate your API key in 1Password or need to re-authenticate.

Comments

Markdown supported