GitHub App

Install the Qassandra GitHub App to run a check automatically on every pull request and post the result back as a GitHub status.

What it does

On pull_request.opened and pull_request.synchronize, Qassandra creates a check for the head commit.
The PR title, description, branch, and changed files are attached as metadata so the flow selector can prioritise relevant flows.
A pending GitHub status is posted immediately. When the check finishes, the status flips to success or failure with a link back to the Qassandra check report.
A summary comment is posted on the PR with pass/fail counts and any new flow suggestions.

Install the app

Open App settings → Integrations for the app you want to connect.
Click Install GitHub App. You'll be redirected to GitHub to choose which repositories Qassandra can access. We recommend granting access only to the repositories you actually want tested.
GitHub redirects you back to Qassandra. The settings page will show “GitHub App installed successfully. Choose a repository to connect.”
Select the repository for this Qassandra app from the dropdown. Each Qassandra app connects to exactly one repository.

Need to add more repositories later?

Click Don't see your repository? in settings. This opens GitHub's installation page where you can add more repos to the existing installation.

What URL gets tested?

For every PR, Qassandra needs a live URL to open. There are two common setups:

Preview deployments — if your CI deploys a per-PR preview (Vercel, Netlify, Render, custom), pass the preview URL as app_url when triggering the check from your CI pipeline. The GitHub App falls back to the configured app URL if you don't.
Single shared URL — if every PR is tested against your staging environment, the configured app URL is used as-is.

Disconnecting

To disconnect the integration from a single Qassandra app, click Disconnect repository in app settings. To uninstall the GitHub App entirely (across all repositories), do that from GitHub's installations page.

Permissions Qassandra requests

Pull requests (read & write) — to read PR metadata and post review comments.
Checks (read & write) — to post the pending/success/failure status.
Contents (read) — to read changed files for smarter flow selection.
Metadata (read) — required by GitHub for any installation.

Qassandra never reads or stores your source code beyond what's needed to identify which files changed in a PR.