Who it is forA maintainer who wants reviews to follow the project's own expectations, such as requiring tests for changes under src/.
The problemGeneric review guidance misses project conventions, and generated or documentation files add noise to every review.
The outcomeA .oss-pr-reviewer.yml file on the base branch that sets the default minimum severity, adds rules, and excludes paths before AI review.
What you need first
- Node.js 20 LTS or newer
- A checkout of the vuphongle/oss-pr-reviewer repository
- An OpenAI API key set as OPENAI_API_KEY (required for live reviews)
- A GITHUB_TOKEN is recommended to avoid anonymous GitHub API rate limits
- Network access to GitHub and OpenAI
Steps
- Copy examples/oss-pr-reviewer.yml from the checkout as a starting point.
- Edit the review.minSeverity, rules, and ignore.paths entries to fit your project.
- Commit the file to the base branch, since the tool loads it from the pull request's base commit rather than the PR branch.
- Run
node dist/cli/index.js review --repo owner/repository --pr 123 --min-severity medium --output review.mdand check the skipped-file section of the report. (inferred, check the README)
Prompt for your agent
In the oss-pr-reviewer checkout, read docs/configuration.md and create a .oss-pr-reviewer.yml for <owner/repository> with one rule and one ignored path. Verify the YAML parses and that the ignored path is listed in the skipped-file section of a generated report. Do not place the file on a pull request branch.
Caveat. Rule text is treated as untrusted guidance, and CLI options override the repository file, so a flag can change the result you expect from the config.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for vuphongle/oss-pr-reviewer and "Set repo-specific review rules and ignored paths"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer