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.