WorkTracker › Connection guides › GitHub

Connect GitHub to WorkTracker

Commits grouped per repo and piece of work, plus PRs and reviews.

What you need

• A GitHub account with access to the repositories you work in.

Setup

1. Create a personal access token

   Go to github.com/settings/tokens and create a token with read access to the repositories you work in (classic: repo scope; fine-grained: Contents and Pull requests, read-only).

2. Fill in the GitHub card

   In Connections → GitHub enter your GitHub username — the handle, not your email — and the token.

3. Sync

   Run a sync — grouped commits, PRs and reviews appear as work items.

What WorkTracker collects

• Your commits, grouped per repository, day and piece of work (ticket key like PROJ-123 or conventional-commit prefix).
• Pull requests you opened and reviews you gave, as work items.
• Commit messages are re-read transiently for AI summaries — the group stores only references.

Read-only access with your own token; only your activity is fetched. Credentials are stored encrypted (AES-256-GCM) and are never shown again or returned by the API.

Troubleshooting

422 Validation Failed … users do not exist

The username field contains an email address. Use your GitHub handle (the name in your profile URL).