OpenCode Mobile <Client>
connect to your OpenCode servers on the go
💫 A lightweight mobile client that wraps the
OpenCode Web
UI as native Android and iOS apps. Connects to an already-running
OpenCode server over LAN or VPN / Tailscale.
Chat with the agent on your phone while the agent and the server run
on your computer and edit code and use all the tools available on it.
🖥️
🔃 Seamlessly continue sessions started on your computer from your phone, or vice versa. Available on Android, iOS and VS Code
Features
- 🌐 Connect to any OpenCode server over HTTP/HTTPS (LAN or VPN / Tailscale when you're away from home🚶)
- ⌨️ Toggleable Enter=newline mode (Enter inserts a newline, Shift+Enter sends the prompt)
- 📱 Injects narrow-screen fixes to the stock OpenCode web UI
- 📋 Multiple server profiles with auto-connect support
-
🔑 Basic Auth support (matching OpenCode's
OPENCODE_SERVER_PASSWORD) - 🎛️ Pull-down menu for server management while connected. Pull to refresh, tap ⋮ to open menu.
- ❤️ Automatic health checks with exponential reconnect
- 🔒 Secure storage for passwords (Keychain / EncryptedSharedPreferences)
-
🌓 Dark theme with light theme support
(
prefers-color-scheme)
How to start your OpenCode Server (REQUIRED TO USE THE APP❗)
The app is a client that connects to a OpenCode web server running on the machine where you have your code and build tools. It needs a running web server to connect to.
No authentication
# start a server without password
opencode web --hostname 0.0.0.0 --port 4096
With authentication (recommended)
export OPENCODE_SERVER_PASSWORD="your-secret-password"
opencode serve --hostname 0.0.0.0 --port 4096
When auth is enabled, the username defaults to
opencode in the app.