Clockify Sync

Guardrails

• No command accepts a user ID override
• All reads and creates are scoped to the token owner returned by GET /api/v1/user
• This skill must be used instead of ad-hoc direct Clockify API calls from the agent

Canonical paths

• Skill code: 90_System/Skills/clockify_sync/adhoc_clockify.py
• Token file: 90_System/secrets/clockify_token.txt
• Wrapper: .agents/skills/adhoc_clockify/SKILL.md
• Current token owner ID noted in script description: 6777eb65c22bea50e6e1c8f9

Commands (Windows)

• Show the token owner:
  • .\.venv\Scripts\python.exe 90_System\Skills\clockify_sync\adhoc_clockify.py whoami
• List projects:
  • .\.venv\Scripts\python.exe 90_System\Skills\clockify_sync\adhoc_clockify.py projects --query "Rockaway"
• List tasks for one project:
  • .\.venv\Scripts\python.exe 90_System\Skills\clockify_sync\adhoc_clockify.py tasks --project "Rockaway / Smart Scout"
• List entries in a window:
  • .\.venv\Scripts\python.exe 90_System\Skills\clockify_sync\adhoc_clockify.py list --start "2026-03-01T00:00:00+01:00" --end "2026-03-08T00:00:00+01:00"
• Summarize time in a window:
  • .\.venv\Scripts\python.exe 90_System\Skills\clockify_sync\adhoc_clockify.py summary --start "2026-01-01T00:00:00+01:00" --end "2026-02-01T00:00:00+01:00"
• Create one entry:
  • .\.venv\Scripts\python.exe 90_System\Skills\clockify_sync\adhoc_clockify.py create-entry --project "Rockaway / Smart Scout" --start "2026-03-11T09:00:00+01:00" --duration-minutes 90 --description "Prep for roadmap review"

Notes

• Use ISO datetimes with timezone offsets when possible.
• If --end is omitted on create-entry, the command uses --duration-minutes.
• Project and task name matching is intentionally strict: ambiguous matches fail fast.
• In this workspace, SmartScout project names are ambiguous across clients. For backfills, resolve projects first and prefer --project-id and --task-id when creating entries.