GitHub
Pull requests, their comments and merges. SeamTrail connects as a GitHub App, and changes arrive by webhook.
Status: Available.
What SeamTrail reads
- Pull requests in the repos you allow: title, description, branch, and when they open and merge.
- Comments on the pull request conversation, and review summaries. A decision written there can start a drift check.
- Pushes and merges, to see how far each ticket's code has gone.
- Ticket numbers in branch names, titles and descriptions. They link a pull request to its tickets.
SeamTrail does not read your code. It flags linked pull requests. Your coding assistant reads the code.
How changes arrive
- Webhook. GitHub sends each change to SeamTrail as it happens.
Permissions
SeamTrail connects as a GitHub App. When you install it, you choose which repositories it can see.
| Permission | Why SeamTrail asks for it |
|---|---|
| Repository contents: read | Check whether a merged change has reached a branch. |
| Metadata: read | GitHub requires it for every app. |
| Pull requests: read and write | Read pull requests. Write is used only for the PR check comment, if your team turns it on. |
| Issues: read | Read comments on pull requests. (GitHub stores them as issue comments.) |
Connect
- Open your org's Settings → Tools.
- Next to GitHub, click Connect. (Org Admins and Managers.)
- Install the SeamTrail app on your GitHub account or organization.
- Pick all repositories, or only the ones SeamTrail should see.
A personal GitHub login is not needed today.
Good to know
- Linking a GitHub repo to a feature needs an org Admin or Manager. SeamTrail can't check your own GitHub access yet.
- Ticket progress (merged to dev, on stage, in prod) and the deploy gate work with GitHub.
- SeamTrail does not post drift on pull requests.
Coming soon
- Comments on lines of code (review comments).