SEMANTYX
All docs
Apply Fix & GitHub

Connecting GitHub

How to create a Personal Access Token, what scopes to grant, and how Semantyx uses it.

4 min read

To use Apply Fix, Semantyx needs a GitHub Personal Access Token (PAT) so it can read your repo files and open PRs. Here's how to create one.

Create the PAT

  • Go to github.com/settings/tokens.
  • Click Generate new token (classic).
  • Give it a name like “Semantyx Apply Fix”.
  • Set expiration to 90 days (or never if you prefer; we recommend rotating).
  • Under Select scopes, check only repo. Nothing else.
  • Click Generate token at the bottom.
  • Copy the token (starts with ghp_) — you won't see it again.

Add it to Semantyx

For now, the PAT is configured server-side as an env var (we'll move to per-user OAuth in a future release). If you're self-hosting, set GITHUB_PAT on your Railway service. If you're a hosted Semantyx customer, email support@semantyxintel.com and we'll set it up for your account.

What we use it for

  • Read repo file trees (to find which file holds a fix)
  • Read individual file contents (to merge the fix into them)
  • Create branches
  • Commit changes
  • Open Pull Requests

We never push to your base branch directly. Every change goes through a PR.