Perch
A semantic linter that checks every changed method against rules you write in plain English, from the command line or on pull requests.
Project links
Project Note
A closer look at Perch
An open-source CLI and pull request check that applies plain-English code rules and model-based bug and security scans to each changed method.
Rules you'd normally leave in a review comment
Some team conventions never fit a regular linter. "Refunds can only process once" or "store timestamps in UTC" depend on what the code means, not how it's formatted. Perch lets a code owner write rules like these in plain English in a perch.yaml file, each with a short name and an ensure line, and checks them on every change.
It parses the repository with tree-sitter and maps each method's callers and callees, so a changed method is read in context. Alongside your rules, it asks the same built-in questions of each changed method: is there a bug, is it a security hole, does it do what its name says, does it need refactoring. The docs show each finding with a confidence figure, such as 72%, which is the model's estimate that the problem is real. Those are leads for a reviewer, not verdicts.
Where it runs
The CLI installs from npm and is MIT-licensed on GitHub. According to the privacy policy, when it isn't connected to Perch Cloud it sends nothing to Perch, and your code goes only to the model provider you configure. That fits a check, fix and check-again loop after a coding agent edits files. The site lists Claude Code, Codex, Cursor, Pi and GitHub among the tools it works with.
Perch Cloud adds a pull request check that fails and comments on the flagged code. In that mode, the relevant source and rule questions go to TypeSafe, the model provider named in the privacy policy. Perch says it doesn't keep source after the analysis, though it keeps a one-way hash of each request with its answer so unchanged code can be served from the cache.
Cost
On October 24, 2026, hosted checks were priced at 10¢ per 1,000 rule checks, with cached checks free. The first $5 of usage is free and needs no card. The homepage estimates about 20¢ for a typical pull request where roughly 60 methods are read. Your cost depends on how many methods a change touches and how many rules you keep.
For reference
Project facts
The published details and source context, together in one place.
- Product
- Perch
- Category
- Other
- Stage
- Other
- Public Context Check
- Public pages were checked Oct 20, 2026.
Project note details
Dates and editorial links
Published
October 24, 2026
Updated
October 24, 2026
Page type
Project Note
Status
Published note
Publication history
Note history
Publication and substantive update dates for this public note.
- Oct 24, 2026
- Project note published.
- Oct 20, 2026
- Public-page information added to the note.
More projects
Related Project Notes

CodeGuard AI
A self-hosted Java and Spring Boot source package for AI-assisted GitHub pull-request feedback, using a choice of model providers.

PrimaLabs
Dedicated inference hosting for open models such as DeepSeek, GLM and MiMo, tuned against each customer's live traffic.
Building something useful?
Submit your project for free. If selected, it gets a profile that explains what it does and links to your work. Publication isn't guaranteed.
Submit a project