Getting started

Install the GitHub App

Sieve runs as a GitHub App. No CI changes. Install once per repo or org, and every schema-touching PR gets reviewed automatically.

One-line install

bash· 1 lines · 43b

gh app install sieve-db --repo your-org/api

You can also install via the GitHub UI at github.com/apps/sieve-db. Pick which repos to grant access to. Sieve requests contents: read, pull_requests: write, and checks: write.

Why we ask for write on PRs

We need pull_requests: write to post review comments and checks: write to mark the PR check pass/fail. We never modify your existing branches and never read other repos. If you turn on autofix, opening a corrected-migration PR also needs contents: write — used only to push the fix to a new branch.

What happens after install

Open a PR that touches your schema or migrations — e.g. prisma/schema.prisma, a Drizzle schema, a Django or Rails migration, or raw SQL.
Within ~60 seconds you should see a check named Sieve / migration safety.
Sieve posts a PR comment with the verdict and a link to the full report at /r/{id}.
Sign in at /login to see review history on your org dashboard.

Optional: .sieve.yml

Add a repo-root .sieve.yml to set the risk level that blocks a merge (blockOn) and opt in to corrected-migration PRs (autofix). See the policy reference.