Installing the GitHub App
From Settings → Integrations → GitHub:- Click Connect GitHub. Stout redirects you to GitHub’s app installation page.
- Pick which repos the Stout app should have access to. You can grant access to all repos, or only specific ones.
- Accept the permissions. Typical scopes include contents, pull requests, and checks — verify the exact set against your installed app’s page in GitHub, since the canonical permission list lives in the GitHub App registration rather than in this repo.
- GitHub redirects back to Stout, which stores the installation ID and a short-lived access token that gets refreshed as needed.
PR Reviewer
Beta. PR Reviewers is in limited availability while we validate it. Reach
out if you’d like to pilot it.
- Watches a repo (optionally scoped to path prefixes, so a monorepo can have one reviewer per product).
- On each pull request, uses a Claude model to author hardware tests for the change.
- Flashes firmware — prebuilt from the repo, or pulled from a CI build artifact — onto an allowed box.
- Runs the generated tests and posts a Stout check back on the PR, with full logs and artifacts a click away.
Troubleshooting
- “Repository not found” when picking a repo — the Stout app doesn’t have access. Go to GitHub → Settings → Applications → Stout and add the repo.
- Checks aren’t appearing on PRs — verify the installation is still active, that a PR Reviewer is configured and enabled for the repo, and that the PR touches any configured path prefixes.
- Committing generated tests fails — if a reviewer is set to commit the tests it writes back to the PR branch, Stout needs
contents: writeon the repo. If the installation predates that permission, reconnect to accept the updated scope.