diff --git a/README.md b/README.md
index 8b6d0860fa..e35fe32bed 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ Notes:
 
 - With 2FA-on-publish, npm may prompt once per package (13 of them). A granular automation token avoids that: `npm config set //registry.npmjs.org/:_authToken <token>`.
 - The wrapper refuses to run when the version is already on npm. For a fork-only re-release between upstream syncs, add a numeric revision to the version in `packages/opencode/package.json` (e.g. `1.17.16-1`, then `1.17.16-2`) — the Nth fork build of that upstream release; the next sync takes upstream's value back. Semver sorts the suffixed form below the bare `1.17.16`, but installs follow the `latest` dist-tag, so that quirk is harmless.
-- Verify after publishing: `npm view codev-code` and `npm install -g codev-code && codev --version`.
+- Verify after publishing: `npm view codev-code` and `npm i -g codev-code && codev --version`.
 
 ## Syncing with upstream
 
diff --git a/packages/opencode/script/publish.ts b/packages/opencode/script/publish.ts
index b833512eea..c641b87ca1 100755
--- a/packages/opencode/script/publish.ts
+++ b/packages/opencode/script/publish.ts
@@ -48,12 +48,10 @@ await Bun.file(`./dist/${pkg.name}/README.md`).write(
   [
     "# CoDev Code",
     "",
-    "The AI agent harness.",
-    "",
     "The recommended install path is the CoDev hub, which also wires up the AI gateway:",
     "",
     "```sh",
-    "npm install -g codev-ai",
+    "npm i -g codev-ai",
     "codevhub install",
     "codev",
     "```",
@@ -61,7 +59,7 @@ await Bun.file(`./dist/${pkg.name}/README.md`).write(
     "Direct install:",
     "",
     "```sh",
-    "npm install -g codev-code",
+    "npm i -g codev-code",
     "codev",
     "```",
     "",