GitHub Activity
WORKloom can connect to your GitHub organisation and surface engineering activity signals for workspace members — directly on their profiles and on the dashboard.
GitHub activity is an activity signal, not a productivity score. WORKloom shows what happened, not how to rank it.
What it tracks
Once connected, WORKloom syncs the following events from GitHub:
- Commits pushed
- Pull requests opened, merged, and closed
- Code reviews submitted and approvals
Activity is displayed as:
- Summary cards — totals over a selected period
- Activity bar chart — daily breakdown for the last 28 days
- Recent events list — individual commits, PRs, and reviews
- Repositories contributed to — which repos a member was active in
- Trend comparison — this week vs last week, or the current period vs the previous one
Where to find it
| Surface | Location |
|---|---|
| Member profile | People → [Member] → GitHub activity section |
| Dashboard widget | Dashboard → GitHub Activity Pulse — shows this week vs last week: commits, PRs opened, PRs merged, reviews |
| Integration settings | Settings → Integrations — connect/disconnect GitHub, manage repos and identity mappings |
Permissions
| Permission | Who has it | What it gates |
|---|---|---|
github.manage | Owner, Admin | Connect/disconnect the GitHub App, manage repositories and identity mappings |
github.view | Owner, Admin, Manager | View team-level GitHub activity |
github.view_own | All roles | View own GitHub activity on your member profile |
Connecting GitHub
Step 1 — Install the GitHub App on your organisation
Go to Settings → Integrations and click Install GitHub App. This takes you to GitHub, where you can install the WORKloom app on your organisation or select specific repositories.
After installation, GitHub redirects back to WORKloom, which stores the connection and triggers the first repository sync automatically.
Step 2 — Map GitHub usernames to members
Go to Settings → Integrations → GitHub identity mapping. For each team member, enter their GitHub username and select their WORKloom account.
Activity from unmatched GitHub usernames appears as "Unmatched GitHub user" until a mapping is added.
Managing repositories
After installation, all accessible repositories appear in Settings → Integrations. From there you can:
- Enable or disable sync per repository using the toggle
- Link a repository to a WORKloom project using the project dropdown
- Use Select all / Deselect all to bulk-toggle sync
Only repositories with sync enabled are included in the hourly sync.
Sync behaviour
WORKloom syncs GitHub activity automatically in the background on a regular schedule. The first sync fetches the last 30 days of activity; subsequent syncs pick up from where the previous one left off.
You can trigger a manual sync at any time from Settings → Integrations → Sync now.
Disconnecting GitHub
Go to Settings → Integrations and click Disconnect. This removes the GitHub App installation and deletes all synced activity data from WORKloom.