diff --git a/docs-site/gpt-gemini-android/index.html b/docs-site/gpt-gemini-android/index.html new file mode 100644 index 0000000..f2c814b --- /dev/null +++ b/docs-site/gpt-gemini-android/index.html @@ -0,0 +1,451 @@ + + + + + +Run GPT & Gemini Coding Agents on Android — OpenCode Mobile + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+
+
+

Run GPT & Gemini Coding Agents on Android

+

+ Prefer OpenAI's GPT models or Google's Gemini models for coding? Neither OpenAI nor Google + publishes an official Android app for agentic coding. OpenCode Mobile fills that gap: it + connects to an opencode server configured with + your own OpenAI or Google AI API key and gives you a full native Android interface to + whichever model you choose. +

+
+

Free and open-source. Bring your own OpenAI or Google API key.

+ Download for Android +
+
+
+ +
+
+

How GPT and Gemini coding agents work on Android

+

+ OpenCode Mobile itself never talks to OpenAI or Google directly — it's a thin client for the + opencode server, and opencode is what actually calls your chosen model provider. In plain terms: +

+
    +
  1. You run opencode (the open-source AI coding agent) on a machine you control — laptop, desktop, or VPS.
    2. +
  2. You configure opencode to use OpenAI (with your OpenAI API key) or Google Gemini (with your Google AI API key) as the model provider.
    3. +
  3. OpenCode Mobile on your Android phone connects to that server over the network.
    4. +
  4. You chat with the agent from your phone — responses stream in real time, file changes render as inline diffs, and shell/tool calls wait for your tap-to-approve before they run.
    5. +
+ +
+ Note on terminology: this is not an official OpenAI or Google product. + OpenCode Mobile connects to the open-source opencode agent (by SST), which supports + OpenAI and Google Gemini as two of its configurable AI backends, alongside Anthropic Claude + and local models via Ollama. +
+
+
+ +
+
+

Choosing between OpenAI and Gemini

+

+ Both are fully supported by opencode; you pick the provider and model in the server config, + and the app streams whatever it produces. Broad strokes for coding work: +

+
+ + + + + + + + + + + + + + + + + + + + +
ProviderTypical strengthsWhat you need
OpenAI GPTBroad general coding ability, strong tool-use, reasoning-tier models for harder refactorsAn API key from platform.openai.com
Google GeminiVery large context windows, competitive pricing, tight integration if you're already on Google CloudAn API key from Google AI Studio or Vertex AI
+
+

+ Exact model names and capabilities change frequently — check your provider's current model + list when configuring opencode. You are not locked in: opencode also supports Anthropic Claude + and local models via Ollama, and you can switch providers on the server at any time without + touching the app. +

+
+
+ +
+
+

What you get on Android

+

+ Whichever provider you choose, OpenCode Mobile gives you the same full agent experience — + not a chat window where you paste code and copy suggestions back: +

+
    +
  • + Reads your entire codebase + The model gets full file-tree access via the opencode server. Ask it to trace a bug across many files — no pasting required. +
    • +
  • + Writes and applies changes + Proposed diffs render in the app's inline viewer; approve or reject per file. Changes apply to the real filesystem on your server. +
    • +
  • + Runs shell commands + Tests, builds, log checks — the agent can execute shell commands on your machine via opencode's tool-call system, gated by your approval. +
    • +
  • + Streams token by token + Responses stream live to your phone instead of a long wait followed by a wall of text. +
    • +
  • + Works across sessions + Sessions persist on the server — pick up a long conversation later, even after closing the app or switching networks. +
    • +
  • + Protects your API key + Your OpenAI or Google key lives on the server, not the phone. The app stores only your server URL and access password, in the Android Keystore. +
    • +
+
+
+ +
+
+

Setting up GPT or Gemini on Android: step by step

+ +
+

Step 1 — Install opencode on your machine

+
    +
  1. Install Node.js 20+ if you don't already have it.
    2. +
  2. Install opencode globally: + 
    npm install -g opencode-ai
    +
    3. +
+
+ +
+

Step 2 — Configure your provider

+
    +
  1. Get an API key — platform.openai.com for OpenAI, or Google AI Studio for Gemini.
    2. +
  2. Set it as an environment variable before starting the server, e.g. for OpenAI: + 
    export OPENAI_API_KEY=sk-your-key-here
    + or for Gemini: + 
    export GEMINI_API_KEY=your-key-here
    +
    3. +
  3. Or add the key to ~/.config/opencode/config.json under the matching provider — see the opencode docs for the exact config shape for your version.
    4. +
+
+ +
+

Step 3 — Start the opencode server

+
    +
  1. Start the server, binding to all interfaces so your phone can reach it: + 
    OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096
    +
    2. +
  2. From your phone's browser, verify: http://<machine-ip>:4096/global/health should return {"healthy":true}.
    3. +
+
+ +
+

Step 4 — Make the server reachable from anywhere

+
    +
  1. Install Tailscale on both your machine and your Android phone (free tier works).
    2. +
  2. Note your machine's Tailscale IP (e.g. 100.x.x.x) from the Tailscale app.
    3. +
  3. Your server URL becomes: http://100.x.x.x:4096
    4. +
+

Alternatives: same LAN Wi-Fi, Cloudflare Tunnel, ngrok. See the full guide for details on each.

+
+ +
+

Step 5 — Install OpenCode Mobile and connect

+
    +
  1. On your phone, install OpenCode Mobile via F-Droid or direct APK.
    2. +
  2. Tap Add Connection.
    3. +
  3. Enter your server URL (http://100.x.x.x:4096) and the password you set.
    4. +
  4. Tap Connect. You're now running GPT or Gemini as your coding agent, from Android.
    5. +
+
+ +

+ Total setup time: about 15 minutes. Not ready to configure a server yet? Tap + Try a Demo in the app first to see the interface with + zero setup. +

+
+
+ +
+
+

Privacy: where your code goes

+

+ When you use GPT or Gemini via OpenCode Mobile: +

+
    +
  • Your prompts and code go from your phone → to your opencode server → to OpenAI's or Google's API. OpenCode Mobile itself never sees or stores your code.
    • +
  • The path from phone to server is over your private network (LAN or Tailscale) — not through any third-party relay.
    • +
  • The path from server to the model provider follows that provider's own terms — see OpenAI's privacy policy or Google's privacy policy.
    • +
  • If data privacy is critical, you can configure opencode to use a local model (e.g. Ollama) so no code ever leaves your network.
    • +
+

+ Your provider API key lives in the opencode server config on your machine — not in the app, + not in any cloud service. The app stores only your server URL and access password, encrypted + in the Android Keystore. +

+
+
+ +
+
+

Frequently asked questions

+
+
+ Can I run a GPT or Gemini coding agent on Android? +

Yes. OpenCode Mobile is a native Android app that connects to an opencode server configured to use OpenAI's GPT models or Google's Gemini models. You get streaming responses, file diffs, and tool call approval from your Android phone — neither OpenAI nor Google publishes an official mobile coding-agent app, so this is the practical route.

+
+
+ Do I need my own OpenAI or Gemini API key? +

Yes. You configure your OpenAI or Google AI API key on the opencode server, not in the app. OpenCode Mobile never sees or stores provider API keys — they live on the machine running opencode serve.

+
+
+ Can I switch between GPT, Gemini, and Claude without reinstalling the app? +

Yes. The model is chosen in the opencode server configuration, not in the mobile app. Change the provider or model on the server and the app simply streams whatever it produces — no app update or reinstall needed.

+
+
+ Is this an official Google or OpenAI app? +

No. OpenCode Mobile is an independent, open-source (MIT licensed) project built by VIBE TECHNOLOGIES, LLC. It is not affiliated with OpenAI, Google, or Anthropic. It connects to the open-source opencode agent (github.com/sst/opencode), which supports GPT, Gemini, Claude, and other models as configurable backends.

+
+
+ How much does it cost? +

OpenCode Mobile itself is free. Model usage is billed by your chosen provider (OpenAI or Google) based on tokens — the same pricing as using their API directly. Check each provider's pricing page for current rates.

+
+
+
+
+ +
+
+

Get started on Android today

+

+ OpenCode Mobile is free, open-source, and available now on Android via F-Droid or direct APK. + You need a machine running opencode serve and an OpenAI or Google AI API key — + both of which you can set up in under 15 minutes by following the + complete setup guide. +

+
+

GPT or Gemini as your AI coding agent — from your Android phone.

+
+ Download OpenCode Mobile + Setup guide +
+
+

+ Also see: Claude on Android · + try the no-setup demo · + OpenCode Mobile vs ChatGPT & Copilot · + full feature list +

+
+
+
+ + + + + diff --git a/docs-site/sitemap.xml b/docs-site/sitemap.xml index f1a0e36..0f8fad4 100644 --- a/docs-site/sitemap.xml +++ b/docs-site/sitemap.xml @@ -61,6 +61,18 @@ 0.6 2026-06-08 + + https://dzianisv.github.io/opencode-mobile/try-demo/ + monthly + 0.8 + 2026-07-18 + + + https://dzianisv.github.io/opencode-mobile/gpt-gemini-android/ + monthly + 0.8 + 2026-07-18 + https://dzianisv.github.io/opencode-mobile/privacy/ yearly diff --git a/docs-site/try-demo/index.html b/docs-site/try-demo/index.html new file mode 100644 index 0000000..cf96139 --- /dev/null +++ b/docs-site/try-demo/index.html @@ -0,0 +1,355 @@ + + + + + +Try an AI Coding Agent With No Server Setup — OpenCode Mobile Demo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+
+
+

Try an AI Coding Agent With No Server Setup

+

+ Curious what an AI coding agent actually looks like on a phone before you set up a server, + an API key, or an account? OpenCode Mobile ships an offline demo — install the app, tap + Try a Demo from the empty state, and watch a full bug-fix walkthrough play + out using the app's real interface. No opencode server, no sign-up, no cost. +

+
+

Zero setup. Zero accounts. See the real UI in under a minute.

+ Download & try the demo +
+
+
+ +
+
+

Why bother with a demo at all?

+

+ Most "AI coding agent on your phone" apps have a chicken-and-egg problem: to find out if the + app is any good, you first have to install opencode, run a server, get an API + key, and wire up a network tunnel — 10 to 15 minutes of setup before you've seen a single + screen. That's a lot to ask before someone even knows if they want the thing. +

+

+ OpenCode Mobile's demo mode removes that barrier entirely. It's a scripted, fully offline + session baked into the app that exercises the same message bubbles, tool call cards, diff + viewer, and permission prompts a real session uses — so you see exactly what driving a real + AI coding agent from your phone feels like, before you touch a terminal. +

+
+
+ +
+
+

What the demo walkthrough shows

+

+ The demo replays the same fixed scenario every time — a small, realistic Android bug fix: +

+
    +
  1. + A bug report + "The login button doesn't respond on Android when the keyboard is open — can you fix it?" +
    2. +
  2. + Visible reasoning + The agent explains its hypothesis: the scroll view is likely swallowing the first tap instead of forwarding it to the button. +
    3. +
  3. + A file search tool call + A grep call locates the relevant handler in LoginButton.tsx, rendered in the same tool call card real sessions use. +
    4. +
  4. + An inline diff + The agent proposes adding keyboardShouldPersistTaps="handled" to the scroll view — shown in the app's real side-by-side diff viewer. +
    5. +
  5. + A permission prompt + The agent asks to run npm test -- LoginButton before finishing. Tap Allow or Deny — the demo shows a different, accurate follow-up for each choice. +
    6. +
+
+ Honesty check: this is not a live AI model answering your questions. It is a + fixed, hardcoded scenario that runs entirely offline — the point is to show you the actual + screens and interactions (streaming bubbles, diffs, tool calls, permission prompts), not to + let you chat freely. For that, you connect a real opencode server afterward. +
+
+
+ +
+
+

How to try it

+
+

Three taps, no account

+
    +
  1. Install OpenCode Mobile from F-Droid or a direct APK — no sign-up required.
    2. +
  2. Open the app. On the first-run empty state, tap Try a Demo.
    3. +
  3. Watch the scripted session play out, then tap Allow or Deny on the permission prompt to see how the agent responds either way.
    4. +
+
+

+ That's the whole thing — no server URL, no password, no API key, and it works in airplane + mode since nothing leaves the device. +

+
+
+ +
+
+

After the demo: connect a real server

+

+ Once you've seen the interface, the natural next step is pointing the app at a real + opencode server so you can actually chat with a + live AI model (Claude, GPT, Gemini, or a local model) about your own codebase. +

+
+

Bring your own server

+

+ On any machine with Node.js: +

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

+ Then in the app, tap Add Connection, enter your server's URL and password + (over the same Wi-Fi, or via Tailscale + for remote access) — and you're driving a real agent instead of the scripted one. + The full setup guide walks through every step. +

+
+
+
+ +
+
+

Frequently asked questions

+
+
+ Can I try OpenCode Mobile without setting up a server? +

Yes. Install the app and tap "Try a Demo" from the empty state. It plays a scripted AI coding agent session — no opencode server, no account, and no API key required.

+
+
+ Is the demo a real AI model answering my questions? +

No. The demo is a fixed, offline walkthrough — the same bug-fix example every time, using the app's real UI components (message bubbles, tool call cards, the diff viewer, permission prompts). It is not a live model call and does not talk to any server or API. It exists to show you the interface, not to answer arbitrary coding questions.

+
+
+ What does the demo walkthrough show? +

A short bug report ("the login button doesn't respond on Android when the keyboard is open"), the agent's reasoning, a file search tool call, an inline diff proposing the fix, and a permission prompt asking to run the test suite — which you can approve or deny to see both outcomes.

+
+
+ Do I need an internet connection to try the demo? +

No. The demo is fully offline and hardcoded into the app — it works in airplane mode. Only connecting to your own real opencode server later requires network access.

+
+
+ Does trying the demo cost anything? +

No. OpenCode Mobile is free and open-source, and the demo doesn't call any AI model or API, so there's no usage cost either. Costs only start if and when you connect your own opencode server with your own provider API key.

+
+
+
+
+ +
+
+

See it for yourself

+

+ No server, no account, no risk — just install and tap Try a Demo. If you like what you see, + the setup guide gets a real opencode server running in about 15 minutes. +

+
+

Free and open-source. The demo works before you've configured anything.

+ +
+

+ Also see: full setup guide · + using opencode on your phone · + OpenCode Mobile vs ChatGPT & Copilot +

+
+
+
+ + + + +