From b802df9797dbe376251cd1f2ad2fa13974f06afb Mon Sep 17 00:00:00 2001
From: Den <2119348+dzianisv@users.noreply.github.com>
Date: Fri, 17 Jul 2026 21:04:51 -0700
Subject: [PATCH] fix(docs): correct server install command opencode ->
 opencode-ai (#113)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

npm 'opencode' returns 404 (does not exist); the real package is
'opencode-ai' (v1.18.3, bin: opencode). Three docs-site pages — including the
setup guide the app's empty state and demo CTA link to — told users to run
'npm install -g opencode', which hard-fails at step 1 and bounces them before
they ever connect. Every other place in the repo already uses opencode-ai.
Verified via npm registry. Corrects guide/, landing index, and
opencode-on-phone pages.


Claude-Session: https://claude.ai/code/session_01T12AhSnQVrSxNnvwfCx2z6

Co-authored-by: engineer <engineer@macbookpro.lan>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
---
 docs-site/guide/index.html             | 2 +-
 docs-site/index.html                   | 2 +-
 docs-site/opencode-on-phone/index.html | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs-site/guide/index.html b/docs-site/guide/index.html
index a9c0f86..d22630c 100644
--- a/docs-site/guide/index.html
+++ b/docs-site/guide/index.html
@@ -235,7 +235,7 @@ footer a{margin:0 8px}
       <li id="step-server">
         <h3>Run <code>opencode serve</code> on your machine</h3>
         <p>Install OpenCode if you haven't already, then start it in server mode. Bind it to all interfaces and set a password so only you can connect:</p>
-        <pre><code>npm install -g opencode
+        <pre><code>npm install -g opencode-ai
 
 OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096</code></pre>
         <p class="muted">Configure your AI provider key on this machine (for example via OpenCode's auth flow or an environment variable). The key never leaves your server.</p>
diff --git a/docs-site/index.html b/docs-site/index.html
index 2132c5b..995514d 100644
--- a/docs-site/index.html
+++ b/docs-site/index.html
@@ -362,7 +362,7 @@ footer a{margin:0 8px}
       <p><strong>You need your own OpenCode server.</strong> OpenCode Mobile is a client, not a hosted service. Before it is useful you must run an OpenCode server somewhere you control and make it reachable from your phone.</p>
       <ol class="steps" style="margin-bottom:0">
         <li>Install and run OpenCode on your machine:<br>
-          <pre style="margin-top:8px"><code>npm install -g opencode
+          <pre style="margin-top:8px"><code>npm install -g opencode-ai
 OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096</code></pre>
         </li>
         <li>Make it reachable from your phone — the simplest secure option is <strong>Tailscale</strong> (connect to your machine's Tailscale IP, e.g. <code>http://100.x.x.x:4096</code>). A Cloudflare Tunnel, ngrok, or the same local network also work.</li>
diff --git a/docs-site/opencode-on-phone/index.html b/docs-site/opencode-on-phone/index.html
index c4c3e7a..198fbd2 100644
--- a/docs-site/opencode-on-phone/index.html
+++ b/docs-site/opencode-on-phone/index.html
@@ -228,7 +228,7 @@ footer a{margin:0 8px}
   opencode serve --hostname 0.0.0.0 --port 4096</code></pre>
       <p style="margin-bottom:0" class="muted">
         Setting a password turns on authentication so only you can connect. (Don't have opencode yet?
-        Install it with <code>npm install -g opencode</code>.)
+        Install it with <code>npm install -g opencode-ai</code>.)
       </p>
     </div>