What is OpenCode Mobile?
OpenCode Mobile is a thin Android client for the OpenCode AI coding agent, built with React Native and Expo. It is not a standalone agent — it connects to an OpenCode server that you run yourself (on your laptop, a VPS, or anywhere you control) and speaks its HTTP + SSE API to browse sessions, stream responses, and review file changes.
All AI model calls happen on your server using your own API keys. The app never proxies your code or conversations through anyone else's servers. It is free and open-source under the MIT license — no feature gate, no ads, and no analytics you did not opt into.
Key features
- Multi-connection managementManage multiple OpenCode servers — local network, Cloudflare Tunnel, ngrok, or Tailscale.
- Streaming chatToken-by-token streaming responses directly from your OpenCode server.
- Diff viewerInline side-by-side diffs of every file change the agent makes.
- Tool call approvalReview and approve or reject tool calls before the agent executes them.
- Biometric unlockFace ID, Touch ID, or Android fingerprint protects the app and individual message sends.
- Secure credential storageServer credentials stored in the Android Keystore via expo-secure-store.
- Session managementBrowse, create, and resume coding sessions on your server.
How to install
Option A — F-Droid (recommended)
Add this repository in any F-Droid client (F-Droid, Droid-ify, Neo Store), then install OpenCode Mobile and get automatic updates:
https://dzianisv.github.io/opencode-mobile/fdroid/repoIn F-Droid: Settings → Repositories → add the URL above (or scan the QR code in the client's "Add repository" screen), then search for "OpenCode Mobile". Your client will ask you to confirm the repo on first connect.
Scan to add the F-Droid repo
Option B — Direct APK
Download the latest signed APK and install it (you may need to allow installation from unknown sources):
Scan to download the APK on your phone
Requirements
You need your own OpenCode server. 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.
- Install and run OpenCode on your machine:
npm install -g opencode OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096 - Make it reachable from your phone — the simplest secure option is Tailscale (connect to your machine's Tailscale IP, e.g.
http://100.x.x.x:4096). A Cloudflare Tunnel, ngrok, or the same local network also work. - In the app, tap Add Connection, enter your server URL and password, and connect.
You bring your own AI provider keys (OpenAI, Anthropic, Gemini, etc.) on the server — your keys, your bill.
New to this? Follow the full step-by-step setup guide.
Frequently asked questions
Is it free?
Yes. OpenCode Mobile is completely free and open source under the MIT license. There is no feature gate, no ads, and no analytics you did not opt into.
Do I need my own server?
Yes — it's a client, not a hosted service. You run an OpenCode server yourself with opencode serve on a machine you control (laptop, desktop, or VPS), and the app connects to it over the network.
Is it on Google Play?
Not publicly yet — Google Play is in internal testing only. You can install it on Android today via our F-Droid repo or the direct signed APK.
Is there an iOS app?
No. OpenCode Mobile is Android only. There is no iOS or iPadOS build.
Where do my API keys live?
On your own OpenCode server. You bring your own AI provider keys (OpenAI, Anthropic, Gemini, etc.) and configure them on the server — your keys, your bill. The app never touches them and never proxies your code or conversations through anyone else's servers.
How do I install it?
Add the F-Droid repo https://dzianisv.github.io/opencode-mobile/fdroid/repo in any F-Droid client and install OpenCode Mobile, or download the latest signed APK from GitHub Releases. See the setup guide for the full walkthrough.