Skip to content
Project Radar

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

PrimaLabs logo

PrimaLabs

Dedicated inference hosting for open models such as DeepSeek, GLM and MiMo, tuned against each customer's live traffic.

Oct 24, 2026Read full Note

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