easy-review documentation

Review diffs at the speed of thought

easy-review (the er binary) is a git diff review tool built for developers who work with AI coding assistants. AI writes code faster than you can read it — er makes review fast, navigable, and live-updating, whether you prefer a keyboard-driven terminal UI or a full desktop application.

er — easy-review ● WATCHING
er· 1 Branch 2 Unstaged 3 Staged 4 PR Diff 5 History ·PR #42 ✓3✗1
💬 4⚠ 3
Files · 7
●src/auth/login.rs⚠1💬2
●src/api/handler.rs⚠1
●src/ui/panel.rs
●src/config.rs💬1
·Cargo.toml
Reviewed: 1/7
src/auth/login.rs+42 −8
@@@@ -20,6 +20,18 @@ impl AuthService {
20− pub fn login(&self, user: &str) -> bool {
20+ pub async fn login(&self, creds: Credentials) -> Result<Session> {
21+ let user = self.validate(&creds).await?;
💬 @reviewer2h ago
Validate token format before issuing?
↳ @author: added a format check
22+ let token = self.issue_token(&user)?;
⚠ SecurityAI finding · P1
Token TTL not checked — expired tokens still validate.
23+ Ok(Session::new(user, token))
j/k files· n/N hunks· c comment· q question· A AI toggle· U next unreviewed
AI summary
Risk · Medium
Findings · 3
●1 high
●2 medium
Checklist
✓Error handling
○Auth flow
○Tests
One screen, the whole review: diff modes, file list with risk dots, a syntax-highlighted diff with inline comments and AI findings, and a live PR/AI panel — updating as your assistant writes code.
◆

New here? Start with Installation, then walk through your first review in the Quick Start. If you just want the key map, jump to the Keybinding Reference.

Two front ends, one engine

er ships as two applications that share the same review engine, the same on-disk review data, and the same core concepts. Pick the one that fits how you work — or use both on the same repository and branch, since they read and write the same review files.

Terminal

The er TUI

A single, self-contained binary. Keyboard-driven, instant startup, runs anywhere a terminal does — perfect next to Claude Code in a split pane.

Desktop

The desktop app

A Tauri application with split diffs, an embedded terminal and browser, multi-model review “arena”, and a settings GUI.

What you can do with it

How this documentation is organized

Most features work the same in both the terminal and desktop apps. Those shared ideas live under Core Concepts. Where the two differ, the dedicated Terminal UI and Desktop App sections cover what is unique to each. Throughout the docs, look for these badges:

both works in the terminal and desktop apps   terminal terminal UI only   desktop desktop app only

If you want to…Read
Install either appInstallation
Run your first review end to endQuick Start
Wire Claude / Cursor / Codex to Easy ReviewMCP Server Setup
Open er inside Herdr worktreesHerdr Integration
Understand the mental modelHow er Works
Learn the diff modesDiff Modes
Comment and ask questionsComments & Questions
Set up the AI review loopAI Review & AI Hub Actions
Connect a GitHub pull requestGitHub & Pull Requests
Customize behaviorConfiguration
Memorize the keyboardKeybinding Reference

A note on your data

er is a viewer and orchestrator. It does not run AI models itself, and it does not transmit your code anywhere. There is no telemetry, no analytics, and no backend — it shells out to your local git (and optionally the gh CLI) and reads review artifacts that AI tools you run write to disk. You bring your own AI tools and credentials. See AI Review for how that loop works.