Pipr runs AI code review from a TypeScript config in your repository. It supports GitHub, GitLab, Azure DevOps, Bitbucket, Gitea, Forgejo, and Codeberg without tying your review policy to one host.
Use the built-in reviewer, start from a recipe, or compose custom tasks and agents with the typed SDK. Pipr validates findings against the changed code before it publishes review comments.
-
Install Pipr and initialize your repository:
curl -fsSL https://pipr.run/install.sh | sh pipr init pipr check -
Add the model-provider secret named by the generated config. For the default GitHub setup:
gh secret set DEEPSEEK_API_KEY -
Open or update a change request. Pipr runs from the generated code-host integration.
See the quickstart for model selection, permissions, and a first review.
- Select models, fallbacks, reasoning levels, timeouts, and retries.
- Limit reviews by path or change-request event.
- Add
@piprcommands and custom TypeScript tasks. - Control inline-comment limits and summary publication.
- Run reviews locally before enabling CI.
Start with the configuration guide, browse the recipes, or use the SDK reference.
| Goal | Page |
|---|---|
| Understand the review model | How Pipr works |
| Configure a repository | Configuration |
| Build custom workflows | Custom tasks |
| Run Pipr outside CI | Local runs |
| Integrate another code host | Code-host guides |
| Look up commands and options | CLI reference |
Pipr runs in your environment or CI runner. It has no hosted control plane.
Pipr sends the configured model provider the repository and change-request context needed for the review, including task instructions and relevant changed code. Provider keys stay in environment variables. Published comments become part of the code host's normal change-request record.
Don't run Pipr on code you aren't permitted to send to the configured model provider. See Trust and security for the full data and execution model.
Read CONTRIBUTING.md before contributing, SECURITY.md to report a vulnerability, and CHANGELOG.md for release history.
Pipr is available under the MIT License.