Skip to main content
Connecting GitHub lets Traversal correlate incidents with recent code changes by pulling commits and pull requests, helping it explain “what changed” alongside telemetry evidence.

​
What Traversal reads

  • Pull requests — recent PRs, diffs, and review comments
  • Commits — commit history and changed files
  • Code — file contents and code search results

​
Setup

1

Install the app

In Traversal, go to Company Knowledge > Integrations, select GitHub, and click Install GitHub App. You’ll be redirected to GitHub to authorize the Traversal app.
2

Select repositories

Choose the GitHub organization and repositories you want Traversal to access. After authorization, you’ll be redirected back to Traversal with the Installation ID populated automatically.
3

Use an existing installation ID (optional)

If the Traversal GitHub App is already installed, you can paste the existing Installation ID instead of running the install flow again.
4

Save

Click Save.

​
Optional scoping

You can optionally narrow GitHub access in Traversal:
  • Use Repositories for a list of repositories in owner/repo format
  • Use Organization for organization-wide access

​
Required permissions (GitHub App, read-only)

Repositories: Commit statuses, Contents, Custom properties, Dependabot alerts, Deployments, Issues, Metadata, Pull Requests Organization: Events, Knowledge bases, Issue Types, Members

​
More information