Postil is a code review gate for pull requests. It publishes findings that can change a merge decision, stays silent on clean changes, and reports gate status separately from advisory review comments.
This repository contains the hosted Postil service: the dashboard, webhook receiver, review worker, billing controls, and deployment configuration. The review engine is the Postil CLI.
- Install the GitHub App for hosted reviews.
- Use the CLI with GitHub, GitLab, Bitbucket, or Azure DevOps.
- View model benchmark results and the raw report.
- Configure review policy for a repository.
- Read the self-hosted guide before deploying the service.
- Read the security model before granting repository access.
Postil uses Bun, Next.js, and PostgreSQL. Copy .env.example to .env, configure a reachable PostgreSQL database and the credentials required for the path under test, then run:
bun install
bun run db:migrate
bun run operational:indexes
bun run jobs:activate-release
bun run devRun focused tests with bun test <path>. Build the production application with bun run build.
- Postil CLI: review engine and local CLI.
- Postil Action: GitHub Actions wrapper.
- Postil Sandbox: review fixture.
Report security issues through GitHub private vulnerability reporting, not a public issue.