Repository navigation
Farol v1.0.0
Farol helps you review code in the order that makes the change understandable, with implementation context alongside the diff.
What you can do
- Review AI-generated code with context from the session that built it.
- Prepare a pull request with a review map explaining what changed and why.
- Review someone else’s pull request, with or without a Farol map.
- Read unified or side-by-side diffs, track reviewed files, and write multiline comments on either side.
- Export and import review maps. Comments and reading progress stay local.
- Use the included agent skills to build maps and publish reviews through GitHub CLI.
Files follow a deliberate reading order rather than an alphabetical file tree. Maps explain implementation decisions; the reviewer makes the judgment.
Install
Download the archive for your platform below:
- macOS Apple Silicon
- macOS Intel
- Linux x86_64
See the README for installation and agent skill setup:
https://github.com/asnunes/farol#readme
SHA256SUMS is included for download verification.
Requirements: macOS 15+ or Linux with glibc 2.35+. macOS binaries are not Developer ID signed or notarized.
Released under the MIT license.