What do you want to do?
3 use cases
-
Score the merge risk of a branch and see which files carry it
Run Farol locally on a feature branch to get a verdict, a risk score and the files to read first.
View prompt
Run winnin/farol on my branch <branch> against origin/main: set up farol.config.json for <stack>, analyze, generate the HTML report, and summarize the verdict, the score and the top 3 risky files.
-
Comment a merge risk report on every pull request in CI
Run Farol on every PR with the winnin/farol/action GitHub Action, fed by your existing coverage and lint reports.
- REPO
winnin/farol - Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Add winnin/farol's GitHub Action (winnin/farol/action) to this repo's PR workflow, feed it our coverage and lint reports, and open a test PR to confirm it comments a verdict.
- REPO
Quick start with Farol
- Check you have what it needs: Node.js 22+ and git; go for Go projects, python3 3.11+ for Python projects; Optional: coverage, lint and audit reports from your CI.
- Open winnin/farol on GitHub and read the README and license.
- Add a Farol.config.json at the project root describing your stack (one line is enough to start)
- Run
npx @winninjs/farol routesto check which pages, endpoints and jobs it found - Check out the branch and run
npx @winninjs/farol analyze --base origin/main --head HEAD --out farol.json - Run
npx @winninjs/farol html --in farol.json --out farol.htmland open the report
These steps come from our top use case, Score the merge risk of a branch and see which files carry it, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for winnin/farol
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 freeAbout this repo
- Who it is forTech leads and reviewers who approve many agent-written pull requests and need to know which ones deserve a close read.
- Why it is hot159 stars, launched 9 days ago, talked about in 3 AI sources we track
- LanguageTypeScript
- Sourcegithub.com/winnin/farol · Back to Hot repos
Requirements
- Node.js 22+ and git
- go for Go projects, python3 3.11+ for Python projects
- Optional: coverage, lint and audit reports from your CI
Add this badge to your README
Maintain Farol? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/winnin-farol/?utm_source=github&utm_medium=badge&utm_campaign=winnin-farol)
HTML
<a href="https://dedupedai.com/use-cases/winnin-farol/?utm_source=github&utm_medium=badge&utm_campaign=winnin-farol"><img src="https://dedupedai.com/badge/winnin/farol.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Farol
What is Farol?
farol is a free, open-source CLI and GitHub Action that runs after your AI code review and tells the person approving a pull request how risky the merge is and which files carry the risk. It uses static analysis with the real compilers to find every page, API operation, job and script the change reaches, gives a verdict and a 0 to 100 risk score, and flags breaking API changes and security findings. It never executes or uploads your code. It is an open-source project on GitHub: https://github.com/winnin/farol.
How do I use Farol?
Add a Farol.config.json at the project root describing your stack (one line is enough to start); then run npx @winninjs/farol routes to check which pages, endpoints and jobs it found; check out the branch and run npx @winninjs/farol analyze --base origin/main --head HEAD --out farol.json. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Farol for?
Tech leads and reviewers who approve many agent-written pull requests and need to know which ones deserve a close read.
What can I do with Farol?
3 use cases so far, for example: Score the merge risk of a branch and see which files carry it; Find every page a shared React component change reaches; Comment a merge risk report on every pull request in CI. Each has steps and a copy-paste agent prompt.
What do I need to run Farol?
Node.js 22+ and git; go for Go projects, python3 3.11+ for Python projects; Optional: coverage, lint and audit reports from your CI.
What are alternatives to Farol?
Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.
Is Farol safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.