diff --git a/README.md b/README.md
index 9868e27..c7e0809 100644
--- a/README.md
+++ b/README.md
@@ -120,7 +120,7 @@ Start a repo-backed VM session and attach `opencode` automatically:
 ./build/bin/banger vm run ../some-repo --branch feature/alpine --from HEAD
 ```
 
-`vm run` resolves the enclosing git repository, creates a VM, copies a git checkout plus current tracked and untracked non-ignored files into `/root/<repo-name>`, and then runs `opencode attach` from the host against the guest.
+`vm run` resolves the enclosing git repository, creates a VM, copies a git checkout plus current tracked and untracked non-ignored files into `/root/<repo-name>`, starts a best-effort guest tooling harness that inspects the repo and installs clearly-needed tools with `mise`, and then prefers a host-side `opencode attach` session when the local client supports it. Older host opencode clients fall back to starting `opencode` inside the guest over SSH. The harness runs asynchronously and logs its output inside the guest.
 
 ## Web UI