A local, single-user tool for reviewing a git branch, leaving line/range comments, and exporting the review as markdown to hand to a coding agent. Go backend + React frontend, shipped as a single binary. See SPEC.md for the design.
The React app builds into web/dist
, which the Go binary embeds — so build the frontend first, then the binary:
cd web
npm install
npm run build
cd ..
go build -o local-review .
./local-review -root /path/to/folder-of-repos
Opens http://127.0.0.1:7777
in your browser. Pick a repository (any git repo
directly under the root), then a head branch (base defaults to the merge-base with
main
/master
), review the diff, click/drag line numbers to comment, then Export to preview, copy, or download the markdown.
The SQLite DB lives next to the binary (local-review.db
), keyed by repo path, so
one install serves many repos and resumes each independently; draft reviews are
pruned after -retention-days
(default 30).
| flag | default | purpose |
|---|---|---|
-root |
||
. |
||
| folder containing one or more git repositories | ||
-port |
||
7777 |
||
| listen port | ||
-retention-days |
||
30 |
||
| prune draft reviews older than this on startup | ||
-no-open |
||
false |
||
| don't auto-open the browser |
Run the Go server and the Vite dev server side by side (Vite proxies /api
to :7777
):
./local-review -root /path/to/folder-of-repos -no-open # terminal 1
cd web && npm run dev # terminal 2 → http://localhost:5173