async-herald/herald-engine — explained in plain English
Analysis updated 2026-05-18
Run rule based code analysis locally on a folder or file without sending code to any server.
Add Herald's CLI to a CI pipeline to fail builds when specific code rules are violated.
Write custom .herald rule files to catch project specific code issues.
Get a quality score and precise, explainable findings across 15 supported languages.
| async-herald/herald-engine | meistrari/pdq | ogham/rust-number-prefix | |
|---|---|---|---|
| Stars | 25 | 25 | 25 |
| Language | Rust | Rust | Rust |
| Last pushed | — | — | 2021-07-20 |
| Maintenance | — | — | Dormant |
| Setup difficulty | moderate | easy | easy |
| Complexity | 3/5 | 2/5 | 2/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires the Rust toolchain and Cargo to build the CLI from source.
Herald is a code analysis tool, written in Rust, that checks your code against explicit rules rather than using an AI model. Its README is written in French. The idea is that every problem it reports comes from a specific, readable rule, not a black box guess, so you always know exactly why something was flagged, and it produces a quality score for your code alongside the issues it finds. It also does not store your code anywhere, everything runs locally. This particular repository is the open source core of the project. It contains the analysis engine itself, which uses tree-sitter to parse fifteen different programming languages, a custom rule language called .herald for writing analysis rules, a set of built in analyzers, and the scoring logic. It ships with 78 free rules covering areas like security, architecture, quality, and reliability. A command line tool called herald-cli lets you run all of this against your own files on your own machine. The author also runs a paid hosted service called herald.codes, which adds things this open source repository does not include, such as browser based analysis, linking private GitHub or GitLab repositories without cloning them, historical reports, team features, CI/CD integration that checks every pull request, support for very large repositories, and premium rule categories. None of that hosted platform or the premium rules are part of this repository. To use it, you clone the repository and build it with Cargo, then run the resulting binary against a folder or a single file, with a JSON output option for scripting or CI pipelines. The project is released under the AGPL-3.0 license, meaning if you offer a modified version of it as a network service, you must publish your changes as source code too.
A Rust code analysis engine that checks code against explicit, readable rules instead of an AI model.
Mainly Rust. The stack also includes Rust, tree-sitter, Cargo.
AGPL-3.0: you can use, modify, and redistribute the code, but if you run a modified version as a network service, you must publish your changes as source code.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.