diff --git a/README.md b/README.md
index 69f950d..0a13298 100644
--- a/README.md
+++ b/README.md
@@ -146,6 +146,16 @@ curl -fsSL https://git.lohmar.co.uk/cclohmar/NewOpenAgents/raw/branch/main/insta
 
 Even though the script arrives over a pipe, it is **interactive**: it reads your answers from the terminal (`/dev/tty`). In a non-terminal context (CI), it runs with safe defaults instead of prompting.
 
+> **If OpenCode's `latest` build won't install** — e.g. `Version 2.0.28 is not available for linux-x64` (upstream publishes the version metadata before the platform binary) — pin the newest published build:
+>
+> ```bash
+> curl -fsSL https://git.lohmar.co.uk/cclohmar/NewOpenAgents/raw/branch/main/install.sh \
+>   | bash -s -- --opencode-version 2.0.27
+> ```
+>
+> Find what's actually published with
+> `curl -s https://registry.npmjs.org/-/package/@opencode/cli-linux-x64/dist-tags`.
+
 ### Or clone, then install (recommended for updates)
 
 ```bash