Documentation
Clocktopus keeps a delivery ledger: every hour and every agent run, attributed to a project and priced. These pages explain how that works and how to wire it up.
Get started
Core
- Automatic trackingHow commits and reviews become priced time entries, what happens when the evidence is incomplete, and how to correct a day.
- AI agentsWhat your coding agents cost, why that never joins your billable hours, and how it reaches a project and a ticket.
- Rates and project budgetsHow job roles price an hour, how effective dating protects last month's reports, and how budgets and margin goals judge a project.
- Reports and insightsWhere the ledger is read back — the dashboard for the shape of a period, the reports for a specific question.
- Delivery metricsWhat the pull request and complexity widgets measure, how to read them honestly, and what they deliberately refuse to tell you.
Setup
- Connect a repositoryInstall the GitHub App or add a webhook by hand, then attach the repository to a project.
- CLISign this machine in, correct the clock, and connect your AI agents — from the terminal.
- Tracked emailsLink commits authored under a different email address to your account.
- Member accessAdd people to an organisation and control which projects each member can see and log time to.
- PermissionsWho can see and do what, by organisation role — one matrix per area of the app.
- MCP serverConnect an MCP-compatible AI assistant so it can read your tracked hours on your behalf.
- Install as an appInstall Clocktopus to your desktop or home screen as a Progressive Web App.