Fast, beautiful diffs on the Go.

diffs is a local-first CLI in a single binary. Inspired by DiffsHub from pierre.computer, it brings a calmer review experience to your working tree and GitHub pull request.

• Offline, local-first review in a single binary.
• Fast local diff viewer with file watching and browser reloads.
• GitHub pull request review and comment.

Download a pre-built binary from the releases page, or build from source.

Install with Homebrew:

brew install --cask imfing/tap/diffs

Run from any git repository:

diffs

This opens http://127.0.0.1:3433/local and reloads when files change.

Review a GitHub pull request (requires the GitHub CLI):

diffs pr                    # PR for the current branch
diffs pr 123                # PR in the current repo
diffs pr org/repo/pull/123  # PR in any repo

Review the current branch against a base locally:

diffs branch          # infers the base
diffs branch main     # explicit base
diffs branch --include-dirty  # include staged, unstaged, and untracked changes

Common flags:

diffs --port 4321 --dir /path/to/repo
diffs pr https://ghe.example.com/org/repo/pull/123
GH_HOST=ghe.example.com diffs pr org/repo/pull/123
diffs pr --gh-host ghe.example.com org/repo/pull/123

The pr command fetches the diff via gh api, which GitHub caps at 300 changed files. For larger PRs, clone the repo and review with diffs after checking out the PR branch:

gh pr checkout 123
diffs

Optional. diffs reads ~/.config/diffs/config.toml on startup:

[ui]
color_scheme = "system"    # system, light, dark
diff_theme = "github"      # github, dark-plus, light-plus, one-dark-pro, ...
diff_style = "split"       # split, unified
ui_font_family = "Aptos"   # preferred UI font stack
code_font_family = "Menlo" # preferred code font stack
word_wrap = false
line_numbers = true
line_backgrounds = true

The file sets initial defaults only. Once you change a setting in the UI it is saved to the browser's localStorage and takes precedence over config.toml on subsequent loads.

diffs comments add --file web/src/App.tsx --line 42 --body "Check this"
diffs comments list

Requires Go 1.26+ and pnpm.

pnpm install
pnpm build

The binary is written to bin/diffs.