Documentation
Everything you need to get started with Clocktopus and make the most of automated time tracking.
Watch the time-lapse to see how Clocktopus turns your commits into a timesheet.
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.
Edge cases
How Clocktopus handles commits outside hours, out-of-order pushes, overnight stretches, and stale open sessions.
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.
Auto-lock past days
Freeze older days so late or rewritten commits can’t change timesheets you’ve already reviewed.
Guides
Step-by-step tutorials to get you started
CLI
Install and use the Clocktopus CLI to clock in/out from the terminal.
MCP Server - Connect an AI assistant
Connect an MCP-compatible AI assistant to read your tracked hours.
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.
Install as an App
Install Clocktopus to your desktop or home screen as a Progressive Web App.
Security, Legal & PII
Privacy, terms, and data protection