Documentation
Everything you need to get started with Clocktopus and make the most of automated time tracking.
Concepts
Understand the core ideas behind Clocktopus
Philosophy
The principles behind Clocktopus: follow good practices, and tracking just happens.
How It Works
Learn how Clocktopus calculates time from your git activity.
Supported providers
GitHub and Bitbucket integrations with webhook signature verification.
Time calculation rules
Define work periods with clock-in/out for accurate break and overtime tracking.
Exceptions
Understand how Clocktopus flags unusual commit patterns for review.
Cross-project tracking
How commits across multiple repositories feed into a single timeline.
Manual entries
Edit automated entries or add manual hours through the web portal.
Mindset
Keep committing and let Clocktopus handle the rest.
Signals
Clock in and out from the terminal to override default work hours.
Guides
Step-by-step tutorials to get you started
CLI
Install and use the Clocktopus CLI to clock in/out from the terminal.
Setup Bitbucket Webhook
Connect your Bitbucket repositories to start tracking time automatically.
Setup GitHub Webhook
Connect your GitHub repositories to start tracking time automatically.
Secondary Emails
Add secondary email addresses to link commits from different accounts.
Security, Legal & PII
Privacy, terms, and data protection