diff --git a/DIVERGENCES.md b/DIVERGENCES.md
index d5c3528712..6535b56bfc 100644
--- a/DIVERGENCES.md
+++ b/DIVERGENCES.md
@@ -12,7 +12,7 @@ future `packages/codev-*`) never conflict and are not tracked here.
 | File | Change | Why | On conflict |
 | --- | --- | --- | --- |
 | `packages/core/src/global.ts` | `const app = "opencode"` → `"codev-code"` | Config/data/cache/state dirs under `~/.config/codev-code` etc. | Keep ours (the one constant); take upstream's surrounding changes. |
-| `packages/opencode/src/index.ts` | `scriptName("opencode")` → `"codev code"`; `show()` prefix check `"opencode "` → `"codev code "` | Help/usage text shows the real user-facing command. The `show()` check must always match the scriptName. | Keep our two strings; take upstream's surrounding changes. |
+| `packages/opencode/src/index.ts` | `scriptName("opencode")` → `"codev"`; `show()` prefix check `"opencode "` → `"codev "` | Help/usage text shows the real user-facing command (the `codev` hub forwards unknown commands to this binary). The `show()` check must always match the scriptName. | Keep our two strings; take upstream's surrounding changes. |
 | `packages/opencode/package.json` | bin key `opencode` → `codev-code` (shim path `./bin/opencode` unchanged) | Installed binary is named `codev-code`. | Keep our bin key; take upstream's other fields. |
 | `bun.lock` | Mirrors the bin key rename above | Lockfile records workspace bin mappings. | Regenerate with `bun install`; never hand-merge. |
 | `README.md` | Replaced with fork README | Fork identity, sync + divergence policy. | Keep ours entirely. |
diff --git a/README.md b/README.md
index f02d30814f..bb958055d2 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # CoDev Code
 
-The AI coding agent of the CoDev ecosystem, invoked as `codev code` through the CoDev CLI.
+The AI coding agent of the CoDev ecosystem. The [codev](https://github.com/quickbeard/codev) hub CLI dispatches to it directly: bare `codev` opens the agent, and any command the hub doesn't claim (`codev run "..."`, `codev serve`, `codev models`, …) is passed through. The installed binary itself is named `codev-code`.
 
 CoDev Code is a fork of [opencode](https://github.com/anomalyco/opencode) that tracks upstream while carrying a small set of organization-specific changes. Read [DIVERGENCES.md](DIVERGENCES.md) before editing any upstream file — it defines where changes are allowed to live.
 
diff --git a/packages/opencode/src/index.ts b/packages/opencode/src/index.ts
index bb4196bf0a..29ba3136f0 100644
--- a/packages/opencode/src/index.ts
+++ b/packages/opencode/src/index.ts
@@ -34,7 +34,7 @@ const args = hideBin(process.argv)
 
 function show(out: string) {
   const text = out.trimStart()
-  if (!text.startsWith("codev code ")) {
+  if (!text.startsWith("codev ")) {
     process.stderr.write(UI.logo() + EOL + EOL)
     process.stderr.write(text + EOL)
     return
@@ -44,7 +44,7 @@ function show(out: string) {
 
 const cli = yargs(args)
   .parserConfiguration({ "populate--": true })
-  .scriptName("codev code")
+  .scriptName("codev")
   .wrap(100)
   .help("help", "show help")
   .alias("help", "h")