From e16f78b255bcf46d8c6f9a4b9e76dd7a3817edeb Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Sun, 2 Aug 2026 12:36:54 -0300 Subject: --- doc.txt | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) (limited to 'doc.txt') diff --git a/doc.txt b/doc.txt index 42929bf..87b0db4 100644 --- a/doc.txt +++ b/doc.txt @@ -1,4 +1,4 @@ -vr — read code and take notes; every call is logged. +vr — read code and take notes; every call is logged in a private jj sidecar. read a file (line-numbered, relative to a jj revision): vr read FILE whole file @@ -19,5 +19,10 @@ vr query -op note shows both the session-local id and the log-wide id used by -reply and vrsite /note/N permalinks. REV is any jj revset; default @ (the working copy). -Every command takes -log FILE for where to append the log -(default ./vr-log.jsonl, or $VR_LOG); use an absolute path across repos. +The repo-local revset alias vr_log names the log change. vr creates it lazily +as an anonymous child of root(); it never appears in the project working copy. +Every new entry records the full target change id and exact target commit id. +An existing repo-root vr-log.jsonl is read and imported on the first append; +vr leaves that legacy working-tree file for you to remove after migration. +The sidecar has no bookmark and is deliberately local-only: a fresh clone will +not contain it, so include the jj repository in backups when notes matter. -- cgit v1.3