diff --git a/packages/kilo-vscode/README.md b/packages/kilo-vscode/README.md
index 8b636361149..aef1c95a4d2 100644
--- a/packages/kilo-vscode/README.md
+++ b/packages/kilo-vscode/README.md
@@ -51,6 +51,8 @@ If you want to contribute or modify the extension locally, see the [DEVELOPMENT.
 To build and share a development snapshot of the extension:
 
 ```bash
+# Run from packages/kilo-vscode/
+
 # Build only (outputs VSIX to system temp dir)
 bun run snapshot:build
 
@@ -58,6 +60,7 @@ bun run snapshot:build
 bun run snapshot:install
 ```
 
+The snapshot version embeds the current commit SHA and your git username (from `git config user.name`), e.g. `7.0.47-snapshot+8ff7f2d02.kirillk`.
 
 ## Contributing