GitHub Integration
Connect GitHub and automatically track commits, PRs, and activity
What is GitHub Integration?
The GitHub integration allows you to connect your GitHub account to Currently and link repositories to projects. Once connected, Currently automatically tracks commits, pull requests, and other activity, creating context updates and keeping your AI briefings up to date.
Requirements
Plan Requirements
GitHub integration is available on Pro, Team, and Enterprise plans. Free plan users can upgrade to access this feature.
How to Connect GitHub
Navigate to Integrations
Go to Settings → Integrations or navigate directly to the Integrations page from your dashboard
Select Your Organization
Make sure you have the correct organization selected. GitHub integrations are connected at the organization level.
Click "Connect GitHub"
Click the "Connect GitHub" button in the GitHub integration section. You'll be redirected to GitHub to authorize the connection.
Authorize Access
On GitHub, review the permissions requested and click "Authorize". Currently requests access to repositories and webhooks to track activity.
Connection Complete
Once authorized, you'll be redirected back to Currently. Your GitHub account is now connected and you can start linking repositories to projects.
Linking Repositories to Projects
After connecting GitHub, you can link repositories to specific projects to automatically track activity.
Open Project Settings
Navigate to the project you want to link a repository to, then go to the Settings tab
Find GitHub Integration Section
Scroll to the GitHub Integration section in project settings. You'll see a list of your available repositories.
Select Repository and Branch
Choose the repository you want to link and select which branch to track (usually "main" or "master")
Link Repository
Click "Link Repository" to connect it. Currently will automatically create a webhook to track activity from this repository.
Understanding Webhooks
Webhooks allow GitHub to notify Currently when activity occurs in your repositories.
Webhook Status
Each linked repository shows its webhook status:
Syncing Webhooks
If a webhook shows as unhealthy, you can click "Sync Webhook" to update the webhook configuration and verify it's working correctly.
What Gets Tracked Automatically
Once a repository is linked, Currently automatically tracks the following activity:
Commits
All commits pushed to the tracked branch are automatically added as context updates
Pull Requests
When pull requests are opened, merged, or closed, updates are created automatically
Issues
Issue activity (opened, closed, commented) is tracked and added to the project timeline
Managing Repository Connections
Unlinking Repositories
To unlink a repository, go to Project Settings → GitHub Integration and click "Unlink" next to the repository. This will stop tracking activity but won't delete existing updates.
Disconnecting GitHub
To disconnect your GitHub account entirely, go to Settings → Integrations and click "Disconnect". This will unlink all repositories across all projects.
Best Practices
- •Link repositories to projects that match their purpose. This keeps updates relevant and organized.
- •Monitor webhook status regularly. Unhealthy webhooks may miss activity updates.
- •Use meaningful commit messages. They become context updates that help your team understand changes.
- •Link multiple repositories to a single project if they're part of the same initiative.
- •Keep your GitHub connection active. Re-authorization may be needed if tokens expire.