Heal
Connect GitHub
Connect GitHub so Staso can read your source during diagnosis and open fix PRs.
| Without GitHub | With GitHub | |
|---|---|---|
| Diagnosis input | Trace data only | Trace data + source at the exact failing version |
| Fix PRs | Disabled | Enabled (requires Deep runs) |
Setup
- Settings -> Integrations in your dashboard.
- Click Connect on the GitHub card.
- Install the Staso GitHub App on your org or personal account.
- Choose All repositories or select specific repos.
Staso matches repos to traces automatically using git tracking metadata. Multi-repo setups work out of the box.
Permissions
- Read: source code — to read files at the exact version your agent ran on.
- Write: contents and pull requests — to push fix branches and open PRs.
No force pushes. No merges. No access outside the repos you select.
Private repos
Supported. Access only to the repos you select, following the standard GitHub App permission model.
Disconnect
Settings -> Integrations -> Disconnect, or uninstall the app from GitHub under Settings -> Applications.
Troubleshooting
| Symptom | Fix |
|---|---|
| Callback fails after install | Click Connect again — the install URL refreshes each time. |
| Wrong repos listed | Update selection in GitHub under Settings -> Applications -> Staso -> Configure. |
| "no source" diagnosis | Verify the trace has git tracking metadata and the repo is connected. |
| Wrong version used | Staso falls back to the latest pushed commit when local changes are uncommitted. |