main 50722cd

Reusable Git diff review TUI in Go.

ero

A terminal UI for reviewing Git diffs file by file.

ero opens the current repository in a GitHub-style review flow, with syntax-highlighted diffs, file navigation, search, and expandable context.

Features

  • smart startup mode for local changes, staged changes, upstream commits, or branch diffs
  • explicit review modes for branch, working tree, staged, local, upstream, commit, and range diffs
  • per-file navigation with a floating file finder
  • reference search across the loaded review
  • expandable unchanged context around diff hunks
  • syntax-aware diff rendering
  • selection copy support
  • active review-provider sync with inline remote review threads
  • GitHub PR overview sheet with Markdown-rendered PR body, issue comments, and review summaries

Install

Download a binary from the GitHub releases page, or build from source:

go install ./cmd/ero

Usage

ero                  # choose a safe review scope automatically
ero branch           # current branch vs default branch
ero working          # unstaged and untracked changes
ero staged           # staged changes
ero local            # staged + unstaged + untracked changes
ero upstream [ref]   # changes against upstream, default @{upstream}
ero commit <rev>     # one commit
ero range <base> <head>

Useful flags:

ero --repo-path /path/to/repo
ero --context-lines 5

Plugins

Ero supports a general local subprocess plugin system, managed with ero plugin install, ero plugin list, ero plugin update, and ero plugin remove. The first shipped contribution type is review_provider, used by the maintained GitHub and pi-coding-agent plugins.

Ero discovers all provider contributions but activates one review provider at a time. The TUI supports provider switching, manual refresh, cache-first sync, and provider sync status. The GitHub plugin uses GitHub CLI-compatible authentication through go-gh and requires gh auth login. See docs/plugins.md for authoring details.

Development

make test
make fmt
make tidy

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. On pages with a side panel: into the panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit; in a file, click a line number to select it, shift-click for a range
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 2

Tags 3

↑↓ moveenter openesc close