From 0ad6cb306cd3d86375692a4ee666ec8b8e37eb2a Mon Sep 17 00:00:00 2001 From: engineer Date: Tue, 2 Jun 2026 17:27:58 -0700 Subject: [PATCH] =?UTF-8?q?docs(site):=20SEO=20content=20sources=20?= =?UTF-8?q?=E2=80=94=20guide,=20FAQ,=20OG=20image,=20sitemap,=20robots?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- docs-site/guide/index.html | 316 +++++++++++++++++++++++++++++++++++++ docs-site/index.html | 119 +++++++++++++- docs-site/og.png | Bin 0 -> 79999 bytes docs-site/og.svg | 26 +++ docs-site/robots.txt | 4 + docs-site/sitemap.xml | 18 +++ 6 files changed, 480 insertions(+), 3 deletions(-) create mode 100644 docs-site/guide/index.html create mode 100644 docs-site/og.png create mode 100644 docs-site/og.svg create mode 100644 docs-site/robots.txt create mode 100644 docs-site/sitemap.xml diff --git a/docs-site/guide/index.html b/docs-site/guide/index.html new file mode 100644 index 0000000..87654e1 --- /dev/null +++ b/docs-site/guide/index.html @@ -0,0 +1,316 @@ + + + + + +How to Run an AI Coding Agent on Android — OpenCode Mobile Setup Guide + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+
+
+

How to run an AI coding agent on your Android phone

+

This guide walks you through running the OpenCode AI coding agent on a machine you control and driving it from your Android phone with OpenCode Mobile — a free, open-source client. You self-host the agent, keep your AI provider keys on your own server, and code from anywhere.

+

OpenCode Mobile is a thin client, not a hosted service. The actual AI coding agent runs on your computer; the app connects to it over the network. That means your code and your API keys never pass through anyone else's servers.

+
+
+ +
+
+

What you need

+
    +
  • An OpenCode server — a computer (laptop, desktop, or VPS) where you run opencode serve.
    • +
  • A way to reach it from your phone — Tailscale is the simplest secure option; a Cloudflare Tunnel, ngrok, or the same local Wi-Fi network also work.
    • +
  • Your own AI provider key — OpenAI, Anthropic, Gemini, or another provider OpenCode supports. The key lives on your server. Your keys, your bill.
    • +
  • An Android phone — there is no iOS app.
    • +
+
+
+ +
+
+

Step-by-step setup

+
    +
  1. +

    Run opencode serve on your machine

    +

    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:

    + 
    npm install -g opencode
+
+OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096
    +

    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.

    +
    2. +
  2. +

    Expose the server to your phone

    +

    Pick whichever fits your setup:

    +
      +
    • Tailscale (recommended) — install Tailscale on both the server and your phone, then connect to your machine's Tailscale IP, e.g. http://100.x.x.x:4096. Encrypted, no ports to open.
      • +
    • Cloudflare Tunnel / ngrok — get a public HTTPS URL such as https://my-opencode.trycloudflare.com.
      • +
    • Local network — if the phone and machine share Wi-Fi, use the machine's LAN IP, e.g. http://192.168.1.100:4096.
      • +
    +
    3. +
  3. +

    Install OpenCode Mobile

    +

    Two supported ways to install on Android today:

    +

    F-Droid (recommended, auto-updates). Add this repository in any F-Droid client (F-Droid, Droid-ify, Neo Store), then search for "OpenCode Mobile":

    + 
    https://dzianisv.github.io/opencode-mobile/fdroid/repo
    +

    Direct APK. Download the latest signed release and install it (you may need to allow installation from unknown sources):

    +
    + Get it on F-Droid + Download APK +
    +
    4. +
  4. +

    Connect and start a session

    +

    Open the app, tap Add Connection, choose your connection type (local network, tunnel, or Tailscale), enter your server URL and the password from step 1, and tap Connect.

    +

    Once connected, create a session and start prompting. The agent runs on your server; responses stream token-by-token to your phone. Review file changes in the inline diff viewer and approve or reject tool calls before they run.

    +
    5. +
+
+
+ +
+
+

Troubleshooting & notes

+
    +
  • Can't connect? Confirm opencode serve is running and bound to 0.0.0.0 (not just 127.0.0.1), and that the URL and port match what you entered in the app.
    • +
  • Tailscale not reachable? Make sure both devices are signed into the same Tailscale network and showing as connected, then use the server's Tailscale IP.
    • +
  • Wrong password? The app password must match OPENCODE_SERVER_PASSWORD exactly.
    • +
  • Where do my keys live? On your server only. The app stores just your server URL and password, kept in the Android Keystore via secure storage.
    • +
  • Local network only at home? The LAN IP works only while the phone is on the same Wi-Fi. For access from anywhere, use Tailscale or a tunnel.
    • +
  • Privacy. No ads, no analytics SDKs, and optional crash reporting is off by default. See the privacy policy.
    • +
+
+

OpenCode Mobile is free and open source under the MIT license. It is an independent client for the OpenCode agent and is not affiliated with the OpenCode upstream project beyond using its open API.

+
+
+
+ +
+
+

Start coding from your phone

+

Spin up your server, install the app, and connect — you'll be running an AI coding agent from your pocket in minutes.

+
+ Get it on F-Droid + Download APK + Back to home +
+
+
+
+ + + + + diff --git a/docs-site/index.html b/docs-site/index.html index d90ee23..2d06e90 100644 --- a/docs-site/index.html +++ b/docs-site/index.html @@ -16,13 +16,13 @@ - + - + - + + + +