diff --git a/packages/opencode/script/publish.ts b/packages/opencode/script/publish.ts
index 677016a2fe..7407b5c9f1 100755
--- a/packages/opencode/script/publish.ts
+++ b/packages/opencode/script/publish.ts
@@ -48,7 +48,21 @@ await Bun.file(`./dist/${pkg.name}/README.md`).write(
   [
     "# CoDev Code",
     "",
-    "Whatever I don't like about the upstream, I'll fix here—and push back upstream because I'm not a selfish brick.",
+    "## Install",
+    "",
+    "```sh",
+    "npm i -g codev-code",
+    "```",
+    "",
+    "## Usage",
+    "",
+    "```sh",
+    "cd your-project",
+    "codev",
+    "```",
+    "",
+    "This opens the interactive terminal UI. Run `codev --help` for the full",
+    'command list, or `codev run "..."` for non-interactive use.',
     "",
   ].join("\n"),
 )
@@ -72,7 +86,7 @@ await Bun.file(`./dist/${pkg.name}/package.json`).write(
   JSON.stringify(
     {
       name: PUBLISH_NAME,
-      description: "Just another AI agent harness",
+      description: "AI coding agent",
       repository: {
         type: "git",
         url: "git+https://github.com/quickbeard/codev-code.git",