Lintrule is a command line tool for making a large language model do your code reviews. Enforce policies your linter can't, find bugs your tests won't, and go beyond "LGTM" without wasting your team's time.
🚨 Fail if we're logging customer data or we'll lose our SOC2 certification.
This is bad:
console.log(user);
This is probably fine:
console.log("user id: " + user.id);
$
rules check$rules billing estimate
Lintrule costs more, the more code you write.
curl -fsSL https://www.lintrule.com/install.sh | bash
In your codebase, setup a .rules
folder with the init command.
rules init
Next, login to Lintrule.
rules login
This will create a file a .rules/no-bugs.md
with your first rule. It's just a markdown file that says "don't approve obvious bugs." Try running it with:
rules check
To save on costs, Lintrule runs on diffs. By default, it runs on the changes since the last commit, effectively git diff HEAD^
. If you want it to run on other diffs, you can pass them in as arguments.
# Check against main and the a feature branch
rules check --diff main..my-feature-branch
# Run on the last 3 commits
rules check --diff HEAD~3
You can ensure rules only run on certain files by adding them to the frontmatter, like this:
---
include: ["**/**.sql"]
---
We're running postgres 8 and have about 1m rows
in the "users" table, please make sure our
migrations don't cause problems.
Yes. By default, Lintrule runs only on changes that come from git diff HEAD^
.
If you're in a GitHub Action, Lintrule smartly uses the GITHUB_SHA
and GITHUB_REF
environment variables to determine the diff. For PRs, Lintrule uses the GITHUB_BASE_REF
and GITHUB_HEAD_REF
.
Yes. Just like a person, the more general the instructions, the more likely it will do something you don't want. To fix false positives, get specific.
On the other hand, Lintrule tends to not be flaky. If a rule produces a false positive, it tends to produce the same false positive. If you fix it, it tends to stay fixed for the same type of code.
include
to silo your rules to certain files. That makes it easier to add more rules without increasing your cost.As LLMs get cheaper to run, we expect the prices to go down significantly.
Not really. Lintrules runs rules in parallel, so regardless of how many rules or files you have, it will complete in a few seconds.