← All integrations

GitHub is where the truth lives: what got built, reviewed, merged, and shipped. GroundTruth reads that record and links every change to the ticket it implements, even when a developer never referenced it.

What we read

• Pull requests: title, branch, author, state, merge and revert status, review decision, and check results.
• Branches, reviews, merges, and deploy signals, the full chain behind "done".
• The ticket key referenced in a branch, title, or body, and we infer the link when it is missing.

What we do with it

GitHub is a read-only ground-truth source: GroundTruth never writes to your code. It compares what shipped against what the tracker says and writes the correct status back to the tracker, gated on acceptance criteria. The optional Definition-of-Done check is the one thing that reports back to GitHub, a PR status check that blocks a merge when the work is not truly done.

Setup

1. Add a GitHub connection in the admin to get a webhook URL and secret.
2. Point your repository webhook (pull request, review, and check events) at that URL.
3. Events flow in and reconcile continuously; clear cases sync automatically, ambiguous ones wait for a human.