From 2ec2a871432a16157dd09fe1baf6793f44f9d71b Mon Sep 17 00:00:00 2001 From: engineer Date: Mon, 8 Jun 2026 05:18:04 -0700 Subject: [PATCH] =?UTF-8?q?seo(site):=20add=20/opencode-on-phone/=20?= =?UTF-8?q?=E2=80=94=20targets=20proven=20'setup=20opencode=20on=20phone'?= =?UTF-8?q?=20query?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Google 'opencode android' surfaces a 40+ comment Reddit thread ('best way to setup opencode on phone') and not us. New high-intent page answers it directly: HowTo + FAQ + Breadcrumb JSON-LD, 4-step setup, tunnel table, Termux contrast. Linked from landing footer + in-content, added to sitemap (priority 0.8). Co-Authored-By: Claude Opus 4.8 --- docs-site/index.html | 3 +- docs-site/opencode-on-phone/index.html | 361 +++++++++++++++++++++++++ docs-site/sitemap.xml | 6 + 3 files changed, 369 insertions(+), 1 deletion(-) create mode 100644 docs-site/opencode-on-phone/index.html diff --git a/docs-site/index.html b/docs-site/index.html index da3b0cf..ec9c4f6 100644 --- a/docs-site/index.html +++ b/docs-site/index.html @@ -301,7 +301,7 @@ footer a{margin:0 8px}
  • Session managementBrowse, create, and resume coding sessions on your server.

    • Full feature list and use cases →

    -

    Comparing options? See OpenCode Mobile vs. ChatGPT & Copilot, OpenCode Mobile vs. Termux, or how to run Claude Code on Android.

    +

    New here? See how to use OpenCode on your phone. Comparing options? Read OpenCode Mobile vs. ChatGPT & Copilot, OpenCode Mobile vs. Termux, or how to run Claude Code on Android.

    @@ -384,6 +384,7 @@ OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4

    Download Setup guide + OpenCode on your phone Features Comparison vs Termux diff --git a/docs-site/opencode-on-phone/index.html b/docs-site/opencode-on-phone/index.html new file mode 100644 index 0000000..aad6936 --- /dev/null +++ b/docs-site/opencode-on-phone/index.html @@ -0,0 +1,361 @@ + + + + + +How to Use OpenCode on Your Phone — The Easy Way (Android) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    + +
    + +
    +
    +
    +

    How to use OpenCode on your phone

    +

    + Want to use the opencode AI coding agent from your + phone? You don't have to wrestle with Termux, SSH tunnels, or a tiny terminal. The clean way is a + native Android app: run opencode serve on your computer, install + OpenCode Mobile, and connect. Five minutes, then you're coding with AI from your pocket. +

    +
    +

    Free, open-source Android client. No Termux required.

    + Get OpenCode Mobile +
    +
    +
    + +
    +
    +

    The short answer: phone = UI, computer = engine

    +

    + opencode is a terminal AI coding agent. It runs where your code lives — your laptop, desktop, or a + VPS — and it ships with a built-in server mode (opencode serve) that exposes an HTTP API. + You don't need to run the agent on the phone. Instead, OpenCode Mobile connects to that server + and gives you a real native interface: session list, streaming chat, inline diffs, and tool-call + approval. Your code, your API keys, and all AI traffic stay between your server and your provider — + the app is a thin client that never proxies anything through anyone else. +

    +
    +
    + +
    +
    +

    Set up opencode on your phone in 4 steps

    + +
    +

    Step 1 — Start opencode in server mode

    +

    On the machine where opencode is installed, run:

    + 
    OPENCODE_SERVER_PASSWORD=yourpassword \
+  opencode serve --hostname 0.0.0.0 --port 4096
    +

    + Setting a password turns on authentication so only you can connect. (Don't have opencode yet? + Install it with npm install -g opencode.) +

    +
    + +
    +

    Step 2 — Install OpenCode Mobile

    +

    + Add the F-Droid repo https://dzianisv.github.io/opencode-mobile/fdroid/repo in any + F-Droid client, or grab the + signed APK directly. + See the download page for QR codes. +

    +
    + +
    +

    Step 3 — Add a connection

    +

    + Open the app, tap Add Connection, and enter your server URL and the password + from step 1: +

    +
      +
    • Same Wi-Fi — use your computer's LAN IP, e.g. http://192.168.1.100:4096
      • +
    • From anywhere — expose the server with Tailscale, a Cloudflare Tunnel, or ngrok, and use that URL
      • +
    +
    + +
    +

    Step 4 — Code from your phone

    +

    + Tap Connect and you're in. Browse and resume sessions, send prompts, watch + responses stream token-by-token, and review every diff before you approve it. Lock the app behind + your fingerprint for good measure. +

    +
    +
    +
    + +
    +
    +

    Reaching your server from outside your home network

    +

    + On the same Wi-Fi, the LAN IP just works. To use opencode on your phone over cellular or away from + home, give the server a reachable address. The most common options: +

    +
    + + + + + + + +
    OptionBest forNotes
    TailscalePrivate, always-on accessFree; gives your machine a stable IP only your devices can reach. Use http://100.x.x.x:4096.
    Cloudflare TunnelA public HTTPS URLFree; a named tunnel keeps a stable hostname across restarts.
    ngrokQuick temporary testingFree tier gives a random URL each run; a static domain needs a paid plan.
    +
    +
    + Always set a server password when the server is reachable beyond your LAN. + OpenCode Mobile stores credentials in the Android Keystore, and you can require biometric unlock + before each send. +
    +
    +
    + +
    +
    +

    Why not just use Termux?

    +

    + Termux is great if you live in a terminal, but for day-to-day AI coding on a phone it means + installing Node, compiling native modules on ARM, wiring up a tunnel by hand, and squinting at a + TUI on a 6-inch screen — then redoing parts of it after updates. If your goal is to use + opencode, a native client is faster and far less brittle. We wrote a full + OpenCode Mobile vs Termux comparison if you want the details. +

    +
    +
    + +
    +
    +

    Frequently asked questions

    +
    + Can I run opencode on my phone? +

    Yes — but you run opencode serve on your computer or VPS, then connect with the OpenCode Mobile Android app. The phone becomes a native UI for your sessions, with no terminal, SSH keys, or Termux required.

    +
    +
    + Do I need Termux to use opencode on Android? +

    No. Termux works but requires installing Node, compiling native modules on the phone, and building a tunnel by hand. OpenCode Mobile is a purpose-built client — install it, enter your server URL once, and connect.

    +
    +
    + How do I connect my phone to my opencode server? +

    On the same network, use the server's LAN IP (e.g. http://192.168.1.100:4096). To reach it from anywhere, expose the server with Tailscale, a Cloudflare Tunnel, or ngrok and use that URL in the app.

    +
    +
    + Is OpenCode Mobile free? +

    Yes — free and open source under the MIT license. No ads, no required accounts, no tracking by default. You bring your own opencode server and AI provider keys.

    +
    +
    + Does it work on iPhone? +

    Not yet. OpenCode Mobile is Android-only today. iOS is on the roadmap.

    +
    +
    +
    + +
    +
    +
    +

    Ready to code from your phone?

    + Download OpenCode Mobile +
    +

    + New here? Read the full setup guide, see the + feature list, or compare it to + ChatGPT & Copilot. +

    +
    +
    +
    + + + + diff --git a/docs-site/sitemap.xml b/docs-site/sitemap.xml index bce25e9..8312682 100644 --- a/docs-site/sitemap.xml +++ b/docs-site/sitemap.xml @@ -43,6 +43,12 @@ 0.8 2026-06-05 + + https://dzianisv.github.io/opencode-mobile/opencode-on-phone/ + monthly + 0.8 + 2026-06-08 + https://dzianisv.github.io/opencode-mobile/privacy/ yearly