OpenCode Mobile

The free, open-source Android client for the OpenCode AI coding agent. Connect to your own self-hosted OpenCode server and write, review, and ship code from your phone.

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/repo

In F-Droid: Settings → Repositories → add the URL above, then search for "OpenCode Mobile".

Option B — Direct APK

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

Download latest APK

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.

  1. Install and run OpenCode on your machine:
    npm install -g opencode
    OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096
  2. 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.
  3. 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.