1 files changed, 10 insertions, 0 deletions

diff --git a/query-doc.txt b/query-doc.txt
new file mode 100644
index 0000000..2887bfc
--- /dev/null
+++ b/query-doc.txt
@@ -0,0 +1,10 @@
+vr query — inspect the read/note log (one line per entry, oldest first).
+
+  vr query                      everything
+  vr query -n 20                last 20 entries
+  vr query -op note             only notes (or: read, grep)
+  vr query -file accounts_db    entries touching a file path substring
+  vr query -session fa7cb1bf    one session (id substring is enough)
+  vr query -log FILE            read another log (default ./vr-log.jsonl, or $VR_LOG)
+
+Filters combine. The log itself is plain JSON lines — jq works on it too.