# Reading code here

Files are read with the `vr` tool — run `vr -doc` once for full usage.

`vr` stores the trace in the repo's private local jj sidecar named `vr_log`.
Do not set `VR_LOG`, pass `-log`, or create a working-tree `vr-log.jsonl`.

- `vr read FILE:START-END` — line-numbered read; prefer ranges over whole files
- `vr grep PATTERN [PATH]` — regex search; scope with a path
- `vr read -r REV FILE`, `vr grep -r REV PATTERN PATH` — at another jj change
- `vr note -f FILE:10-42 -t struct TEXT...` — record observations as you read

Navigate top-down: grep for the symbol, read the enclosing range, note what
you learn. Every entry records the full current jj change and commit IDs; the
sidecar append does not modify the project's working-copy change.