"this code shall eventually pass"
A local-only "code review" tool designed for working alongside an AI agent.
Review and comment on uncommitted changes in a browser-based UI powered by a local Swift server.
gandalf makes no network requests, and depends only on git, a browser, and Swift packages shipped by Apple. It persists review state in .gandalf.
gandalf is a Swift CLI that runs a local HTTP server serving embedded HTML/CSS/JS.
To install, download gandalf-<version>-macos-arm64.zip from Releases, unzip it, and add gandalf to your PATH.
Alternatively, build gandalf from source. From the repo root:
swift build -c release --package-path GandalfServer
./gandalf # symlink to the built productFor releasing, see GandalfRelease/.
Navigate to the directory with changes to review, and run gandalf. That's it!
cd /path/to/repo-under-review
gandalfSee gandalf --help for full usage.
Review should be familiar if you've used browser-based code-review tools before. Submitting a review provides you with self-describing, copy-paste ready feedback in Markdown.
Submitting a review "checkpoints" changes, such that you can subsequently re-review only the diff since your last submitted review.
See also: docs/.