opencode-mobile

OpenCode Mobile — open-source Android client for the OpenCode AI coding agent. Run AI coding sessions from your phone against your self-hosted server over Tails

What is opencode-mobile?

OpenCode Mobile — open-source Android client for the OpenCode AI coding agent. Run AI coding sessions from your phone against your self-hosted server over Tailscale. Available on F-Droid.

Overview of opencode-mobile

What it is

OpenCode Mobile is an open-source Android client for the OpenCode AI coding agent. It allows running AI coding sessions from a phone against a self-hosted server over Tailscale, local network, Cloudflare Tunnel, or ngrok. The app is built with React Native / Expo and is available on Google Play, F-Droid (self-hosted repo), and as a direct signed APK. It is not affiliated with the opencode team.

Key features

  • Offline demo mode — tap “Try a Demo” to see a full bug-fix walkthrough with zero setup - Multi-connection — manage multiple opencode servers (local network, Cloudflare Tunnel, ngrok, or Tailscale)
  • Biometric unlock — Face ID, Touch ID, or Android fingerprint protects the app and individual message sends - Streaming chat — token-by-token streaming responses directly from your opencode server - Diff viewer — inline side-by-side diffs of every file change the agent makes - Tool call approval — review and approve (or reject) tool calls before the agent executes them - Secure credential storage — server credentials stored in the Android Keystore via expo-secure-store - Session management — browse, create, and resume coding sessions

Use cases

Connect to your own self-hosted opencode server over your local network, a Cloudflare Tunnel, ngrok, or Tailscale — and write, review, and ship code from anywhere. The offline demo mode lets you explore the app’s chat, diff, and permission-approval UI without a server.

Getting started

Don't have a server yet? Install the app and tap Try a Demo on the Sessions screen first — no setup required. Step 1 — Start opencode on your machine bash npm install -g opencode-ai OPENCODE_SERVER_PASSWORD=yourpassword opencode serve --hostname 0.0.0.0 --port 4096 Step 2 — Install OpenCode Mobile via Google Play, F-Droid, or a direct APK (or build from source — see CONTRIBUTING.md). Step 3 — Add a connection in the app Open the app, tap Add Connection, and choose your connection type (local network, tunnel, or Tailscale). Enter the password from Step 1 and tap Connect.

License and pricing

OpenCode Mobile is free and open-source under the MIT license. There is no feature gate, no telemetry you did not opt into, and no ad network. The app itself has no pricing; optional GitHub Sponsors tiers ($5/mo, $15/mo, $50/mo) exist to support development but are not required.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/dzianisvopencode-mobile.svg)](https://yunodb.com/tools/dzianisvopencode-mobile?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/dzianisvopencode-mobile?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/dzianisvopencode-mobile.svg" alt="Featured on YunoDB" height="20"></a>