| name | time-tracking |
| description | Manage time tracking with Toggl or Clockify — timers, timesheets, logging hours, viewing entries, manual entries. Triggers on 'toggl', 'clockify', 'time tracking', 'timer', 'log time'. |
Time Tracking
Use scripts/track for all time tracking operations. Supports both Toggl (default) and Clockify.
Commands
scripts/track start "Task description" -p "Project Name"
scripts/track stop
scripts/track current
scripts/track start "Task description" -p "Project Name" -P clockify
scripts/track current -P clockify
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"
scripts/track delete <entry-id>
scripts/track entries --days 7
scripts/track projects
scripts/track me
scripts/track project:create "Project Name"
scripts/track project:create "Project Name" -b
scripts/track project:create "Project Name" --private
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
scripts/track cache:clear:all
Use these if you rotate your API key in 1Password or need to re-authenticate.