GitHub Integration - TraceRoot

GitHub integration lets the AI agent clone your repo in a sandbox, read the source code behind failing spans, and create fix PRs — all from within TraceRoot.

Setup

Go to Workspace Settings -> Integrations in the TraceRoot dashboard and Connect GitHub App.
Grant access to the repositories you want to connect

Permissions

Permission	Access	Why
Metadata	Read-only	List repositories, collaborators, and access repository metadata (mandatory)
Contents	Read and write	Clone and read source code for debugging; create fix PRs
Pull requests	Read and write	Create fix PRs from root cause analysis; read PR context
Issues	Read and write	Create and manage issues; read issue context for debugging
Commit statuses	Read-only	Read commit statuses for trace correlation
Discussions	Read-only	Read discussions and related context

Requirements

For source code correlation to work:

The TraceRoot GitHub App must have access to the repository
Traces must include git context typically auto-detected by the SDK

Git context is captured automatically for every span when you use the @observe decorator. See Git Context.

⌘I