diff --git a/Cargo.lock b/Cargo.lock
index 72be2449..935edef5 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -3227,7 +3227,7 @@ dependencies = [
 
 [[package]]
 name = "zerograph"
-version = "0.6.1"
+version = "0.6.2"
 dependencies = [
  "anyhow",
  "ast-grep-language",
diff --git a/Cargo.toml b/Cargo.toml
index 729430f7..2d0bddb3 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "zerograph"
-version = "0.6.1"
+version = "0.6.2"
 edition = "2021"
 rust-version = "1.98"
 description = "A project knowledge graph built and queried at zero API tokens"
diff --git a/README.md b/README.md
index f14282cc..792f21fa 100644
--- a/README.md
+++ b/README.md
@@ -33,15 +33,16 @@ Sources: [the three-tool run](docs/bench/2026-09-04-three-graphs-results.md) and
 ## Get started
 
 ```bash
-pnpm add -D zerograph                      # prebuilt: macOS arm64, Linux x64, Windows x64
-pnpm add -g zerograph                      # or globally with pnpm
-npm install -g zerograph                   # or globally with npm
-cargo install --path .                     # or from source
-
-zerograph build                            # full build into .zerograph/ (add it to .gitignore)
-zerograph ask cancellation policy          # answer in a few lines
+npm install -g zerograph                   # or: pnpm add -D zerograph
+echo .zerograph/ >> .gitignore             # the graph is built per checkout
+zerograph build                            # first run downloads the embedding model (~1.2 GB)
+zerograph ask cancellation policy          # stays fresh with your edits, no update to run
+zerograph install-agent --claude           # optional: MCP server + git hooks (or --codex)
 ```
 
+Prebuilt for macOS arm64, Linux x64 and Windows x64. Defaults read markdown and code in 24
+languages; a `zerograph.toml` changes that ([Configuration](docs/configuration.md)).
+
 - On Windows: [Windows notes](docs/install.md#windows-notes).
 - Upgrading from repograph: the old store, config and variables are read where they are, see
   [coming from repograph](docs/install.md#coming-from-repograph).
diff --git a/docs/commands.md b/docs/commands.md
index bb5655f4..65eefcf2 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -2,7 +2,7 @@
 
 ## Status
 
-0.6.1 is the version `main` carries. Its default globs read TypeScript and JavaScript, Kotlin, Java,
+0.6.2 is the version `main` carries. Its default globs read TypeScript and JavaScript, Kotlin, Java,
 C#, Rust, Python, Dart, Swift, GraphQL, SQL, Bicep, HCL, Shell, Vue, Lua, Go, C, C++, PHP, Ruby,
 Scala, Elixir and OCaml; every command below is
 implemented rather than planned:
diff --git a/docs/releases/0.6.2.md b/docs/releases/0.6.2.md
new file mode 100644
index 00000000..606485b3
--- /dev/null
+++ b/docs/releases/0.6.2.md
@@ -0,0 +1,12 @@
+# zerograph 0.6.2
+
+The release notes for the GitHub release page. The why behind each change is in the docs each line
+links to.
+
+## Fixes
+
+- **The npm page shows the repository's README**, badges, navigation and the comparison image
+  included. The package used to carry a short hand-kept copy that had drifted from it; the README
+  is now cut from the root one at pack time, every relative path pinned to the release tag.
+
+No change to the binary since 0.6.1.
diff --git a/npm/zerograph/package.json b/npm/zerograph/package.json
index 5e78e8a9..ac034177 100644
--- a/npm/zerograph/package.json
+++ b/npm/zerograph/package.json
@@ -1,6 +1,6 @@
 {
   "name": "zerograph",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Knowledge graph of a repository's requirement docs and code in 24 languages, built and refreshed at zero model tokens, asked by id, keyword or paraphrase",
   "license": "MIT",
   "repository": {