diffr.1

.TH DIFFR 1
.SH NAME
diffr \- structural Git comparisons and local diff streaming
.SH SYNOPSIS
.B diffr
[OPTIONS] [REVISION [REVISION]] [-- PATHSPEC...]
.br
.B diffr --no-index
BEFORE AFTER
.br
.B diffr
REVISION REVISION --format ndjson
.SH DESCRIPTION
Without revisions, compare index to working tree. With --cached, compare HEAD
to index. With one revision, compare it to working tree. With two, compare
their trees. A...B compares merge-base(A,B) to B; A..B compares A to B.
.SH OPTIONS
.TP
.B --repo DIRECTORY
Discover the repository from DIRECTORY (default current directory).
.TP
.B --cached, --staged
Compare a revision (default HEAD) to the index.
.TP
.B -R
Reverse before and after.
.TP
.B --name-only, --name-status, --stat, --numstat, --shortstat
Print metadata without syntax matching. Stat counts are textual.
.TP
.B --quiet, --exit-code
Exit 1 for changes. Quiet also suppresses output. Errors exit 2.
.TP
.B --format ndjson
Write the event stream described under STREAMING instead of opening the
terminal UI, which needs a terminal.
.TP
.B -U N
Ordinary context padding (default 3).
.TP
.B --config FILE
Read this TOML file in place of the global configuration file; it must exist.
.TP
.B --help
List supported options. Unsupported Git flags are rejected.
.SH STREAMING
--format ndjson emits start, file, file_error and complete records to stdout.
Computation and output run on separate threads with a bounded queue.
See docs/streaming.md for the event schema and exit status contract.