GitHub
Connect a repository (no code access)
On this page
Connecting GitHub tells MindBacklog what reached your repository: commits and merged pull requests, the GitHub checks on your latest commit, and secret-scanning alerts. Publish check and Launch use them. MindBacklog gets no token, no app installation and no access to your code: GitHub sends a small notice (a webhook) and MindBacklog reads only that.
Connect it (the product's admin)
- Open Settings › Connections.
- Under Tools that sync, in the group for where the work is (Jira, Linear, GitHub), find the GitHub tile.
- Turn its Sync switch on. A window opens: Add this webhook to your repository, with a Payload URL and a Secret, each with Copy.
- Copy both now. The secret is shown once.
- In your repository on GitHub: Settings, Webhooks, Add webhook. Paste the URL and the secret. Content type
application/json. Events: push, pull requests, check suites and secret scanning alerts. - Back in MindBacklog, press Done. The tile shows the repository's name once the first notice arrives.
Only the product's admin can connect. Everyone else sees the status.
What is read, and what never is
Per notice, MindBacklog keeps only:
- a commit: its sha, the first line of its message (up to 200 characters), the author's login, time and link;
- a pull request: number, title, state, base and head branch names, merge sha, author's login and link;
- a check suite: id, head sha and branch, status and conclusion;
- a secret-scanning alert: number, state, the kind of secret and a link. Never the secret itself.
It never keeps message bodies, file lists, diffs or emails.
New secret, disconnecting
- New secret (on the GitHub tile, once it is on) makes another secret. Paste it into the repository's webhook settings; notices signed with the old one are refused from then on.
- Turning Sync off disconnects. What GitHub already sent stays. MindBacklog stops accepting notices (GitHub shows a failure on the webhook's page); delete the webhook in the repository's settings too.
Ask Mind can also look things up (Growth and Scale)
The tile's Ask switch signs you in to GitHub so Ask Mind can look up issues and pull requests live: read-only, never code, nothing stored, never counted as evidence. Turning Ask off forgets the connection. On Starter the Ask switch is replaced by a lock; Sync works on every plan.
FAQ
Does MindBacklog read my code? No. It has no token and no installation, only the webhook's notices above.
Why does the tile show no repository? The name appears after the first notice arrives. Check that the webhook's
Payload URL and secret match, and that its content type is application/json.