← All guides

Automate / UPDATED 10 OCTOBER 2026

Review new commits automatically

Enable advisory GitHub reviews and understand delivery evidence.

Enable automatic reviews

A repository administrator or maintainer enables automatic reviews in Repository context. One maintainer manages automation for each installation/repository. New and updated supported pull requests can create commit-pinned reviews. Draft PRs and private repositories are excluded from automatic review in this beta.

GitHub displays an advisory NodeDots check with a neutral conclusion and a link to the initiating maintainer’s authenticated report. Reports are shared only when the owner grants access.

Check delivery, not just configuration

Shipping setup checks App configuration, PR event subscription, webhook URL, and recent PR delivery for the repository when GitHub makes that metadata available. No recent delivery observed means delivery has not been established from the available history.

If automation is off, signing credentials are missing, or webhook verification is unavailable, review manually while the maintainer investigates. Turning automation off prevents queued automatic jobs from proceeding.

For self-hosting operators

Configure a GitHub App with Contents read, Pull requests read, Metadata read, and Checks write. Commit-status visibility may require Commit statuses read. Enable Pull request events and use /api/workspace/github on your app origin with the same webhook secret as the service.

Use Cloudflare D1, the nodedots-reviews queue, and the workspace consumer. Keep App keys, auth secrets, and runner credentials server-side. This public guide describes the hosted workflow; deployment-specific credentials belong in the operator’s secret manager.