Revu
Revu is an open-source local reading surface for reviewing AI-written codebases, anchoring remarks to lines and exporting them as one markdown document.
At a Glance
About Revu
Revu is an open-source tool from Enspirit for reading and annotating a project that an AI agent wrote. It runs locally, opens the repository in the browser, lets reviewers attach tagged remarks to specific lines, and exports a single markdown review to hand to a colleague or an agent.
What It Is
Revu is a code-reading and review tool built for repositories too large to review as a diff. Instead of a file tree, the left pane lists scopes: named sets of places to look, such as the last commit, changes on the branch, the longest documents, the largest sources, files no test names, or files with broken links. Each scope is described as a place to look, not a claimed defect. The center pane renders markdown or shows code with line numbers and syntax colour, and the right pane holds the review remarks.
How Reviews Work
A reviewer clicks a line number (or a range), or selects text in a rendered document, then adds a remark tagged must-fix, question, scope, idea, praise or note. Remarks are stored outside the project in one JSON file per project under the user's state directory. The export is one markdown document in which each remark repeats its path and quotes the lines it refers to, with instructions to treat each remark as a requirement. When a remark is anchored to rendered markdown by text matching, the export marks it as an approximate anchor.
Configuring Scopes
An optional .revu.yml at the project root declares the title, reading order, paths to skip, and which scopes to offer on what thresholds. Custom scopes can run any command that prints locations, such as a linter, a type checker or git grep; output in path:line: message, tsc style or bare-path form is read. Commands run only when the scope is entered. revu --skill prints agent instructions so a coding agent can write the configuration after finding the project's own harness.
Design Boundaries
Revu opens the project read-only and contains no AI itself; the authors say the judgement is the product. It binds to 127.0.0.1, has no authentication, and sends nothing anywhere. Lockfiles, binaries, images and files over 500 kB are not offered. It has three dependencies (marked, yaml, highlight.js), needs Node 20 or later, and is MIT licensed.
Community Discussions
Be the first to start a conversation about Revu
Share your experience with Revu, ask questions, or help others learn from your insights.
Pricing
Open Source
Revu core is free, open source under the MIT licence; runs locally on 127.0.0.1.
- MIT licensed
- Runs locally, binds to 127.0.0.1, sends nothing anywhere
- Install via npm install -g @enspirit/revu
- Scopes-based reading surface and markdown review export
- No AI inside Revu
Capabilities
Key Features
- Scope-based navigation instead of a file tree
- Built-in scopes for last commit, branch changes, working tree, churn, largest sources, untested files, orphans, broken links and TODOs
- Custom scopes from any command that prints file locations
- Line-anchored remarks with must-fix, question, scope, idea, praise and note tags
- Single markdown review export
- Read-only access to the project under review
- Remarks stored outside the project in a per-project JSON file
- Markdown rendering with source toggle and syntax-highlighted code
- Light and dark themes
- Agent skill for generating .revu.yml configuration
- Local-only server bound to 127.0.0.1
