diff options
Diffstat (limited to 'constrain')
| -rw-r--r-- | constrain/README.txt | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/constrain/README.txt b/constrain/README.txt index 01657a8..4eee9a1 100644 --- a/constrain/README.txt +++ b/constrain/README.txt @@ -15,16 +15,21 @@ codex-config.toml optional: centralize VR_LOG for codex AGENTS.md how-to-navigate-with-vr guidance for the repo ── one-time setup ────────────────────────────────────────────────────────── -put vr on PATH: go build -o ~/.local/bin/vr . (repo root, not vrsite/) +put both on PATH: go build -o ~/.local/bin/vr . (repo root) + cd vrsite && go build -o ~/.local/bin/vrsite . + (vr is what agents call; vrsite is how you read the trace) ── running a constrained CLAUDE investigation ────────────────────────────── No repo mutation needed; from the target repo dir: VR_LOG=/abs/path/trace.jsonl \ - claude -p --settings /Users/goblin/00-projects/0x4200.cafe/vr-agent-logger/constrain/claude-headless-settings.json \ + claude -p --settings <vr-repo>/constrain/claude-headless-settings.json \ --allowedTools 'Bash(vr)' 'Bash(vr:*)' \ < prompt.txt > report.md + (<vr-repo> is wherever this repo lives; the settings file's hook path is + absolute into this directory, so it must be spelled out in full) + - --allowedTools on the CLI is required headless: allow rules inside settings are IGNORED until the workspace is trusted (deny rules and the hook always apply). Interactive use instead: install claude-settings.json @@ -53,8 +58,12 @@ No repo mutation needed; from the target repo dir: line-atomic. Same file = one merged timeline for free. - In the prompt, tell the agent to leave pinned notes (vr note -f FILE:START-END -t kind "...") — that is the payload. - - Render the trace afterwards: - vrsite/vrsite -log trace.jsonl -repo <repo> -out site -title "..." + - Read the trace afterwards — serve it, and write notes of your own back + into the same log: + vrsite -log trace.jsonl -repo <repo> -title "..." + or take a static copy to hand around (one change, no server features): + vrsite -log trace.jsonl -repo <repo> -out site -title "..." + `vrsite -h` explains both, and what a log needs to be worth reading. ── known holes (accepted) ────────────────────────────────────────────────── Scripting runtimes (python/node/perl) can still open files — uncomment their |