Commit addresses

Git stamps every commit with the email in your local config. If that is not the email you sign in to Clocktopus with, the commit arrives with nobody to attach it to. It is kept, but it produces no time until someone says who wrote it.

Find out which email your commits use

git config user.email

Run it in a repository you actually work in — a repo-local user.email overrides the global one, which is exactly the case that catches people out.

Add it and confirm it

Open Git identities from your avatar menu, find Commit addresses, and add the address. Clocktopus emails it a confirmation link. Once you open the link and press Confirm, commits from that address count as yours on every stream: your own webhook, your GitHub App install and your organisation's.

Until the link is confirmed nothing is claimed, so adding somebody else's address gets you nothing.

Add as many as you need. A work laptop, a personal machine and a users.noreply.github.com address are three different authors as far as git is concerned, and all three can point at you.

Addresses you added before confirmation existed show as Unconfirmed. They count only in the organisations they were assigned in; press Send confirmation to make them count everywhere.

Or connect GitHub or Bitbucket

On the same page, Connect GitHub or Connect Bitbucket records what the provider has already verified: your account and every address it has confirmed. Those count as yours in every organisation with no confirmation email, and they follow the provider — an address you remove there stops counting here at your next sign-in or Re-sync.

On Bitbucket this also covers an address that is not a mailbox, once Bitbucket itself links it to your account (for example through a repository's username aliases): after it has arrived in more than one of your own pushes, it is treated as yours.

Addresses that are not a mailbox

Many commit addresses cannot receive mail: [email protected], a pairing alias, a CI identity. For those, go to To sort → Commit authors and open the menu on the address:

• Every webhook and GitHub App install is connected for an organisation, so every commit arrives in one. Only its owners and admins answer there.
• Assign to me assigns the address to yourself, if you own or administer the organisation — you always do in the one signup gave you.
• Assign to a member assigns it to any other member. Members cannot assign addresses; they confirm by email, connect GitHub or Bitbucket, or ask an admin.
• Invite sends an organisation invitation, prefilled from the commit. When it is accepted, the commit address is assigned to the new member.
• Not a person marks a bot or CI address. Its commits stay stored and never produce time. Bots such as dependabot and github-actions are suggested for this automatically.

From now on, never backwards

Every one of these applies from the moment it is made. Commits that arrived before are kept but not re-counted, so past and locked days never change. To recover time from before, log it by hand.