Skip to main content
Connect GitHub so Tracelit can pull source for root-cause analysis and open pull requests with proposed fixes. Nothing merges without your review.

​
Connect GitHub

1

Install the Tracelit GitHub App

In the app, go to Settings → Integrations → GitHub and click Install GitHub App. Authorize access to the organizations and repositories you want Tracelit to use.
2

Link a repository

Select the site or service in the circle selector, open Utilities → Repository, and link a repo the App can access.
3

Map branches

Set Development and Production to the branches Tracelit should analyze and patch for each environment.
4

Enable resolution gates

Under Utilities → Environment, turn on Allow resolutions (and Code analysis for backend services) for environments you trust.
Unlinking the repository stops new code-backed resolutions until you link again. Historical PRs are unchanged.

​
What happens when an incident fires

1

Incident opens

An error spike or exception creates an incident on the linked site or service.
2

Pull workspace

From the resolution workspace, pull the mapped branch. Browse the tree and open the frame that matches the stack.
3

Root cause

Liter reasons over the real source — not a summary — and writes the cause and recommended next steps.
4

Open a PR

After verify, Tracelit opens a pull request on a fresh branch with the diff, root-cause summary, and a link back to the incident.
Tracelit never pushes directly to your default branch. Every fix lands on a separate branch and goes through your normal PR process.

​
Permissions

The GitHub App needs enough access to:
  • Read repository contents (for workspace pull and analysis)
  • Create branches and pull requests (for autonomous resolution)
  • Receive webhook events so PR merge/close updates the incident and resolution job
You control which repositories the App can access during install (and later in GitHub → Settings → Applications).

​
Webhooks

Tracelit listens to GitHub events on linked repositories:

​
Auto-merge (optional)

Configure per service whether Tracelit may merge high-confidence PRs after CI passes. Branch protection and required checks are always respected. See GitHub PR for auto-merge settings and confidence thresholds.