OpenCode Mobile Documentation
OpenCode Mobile is a community-built Android and iOS client for an OpenCode server that you run yourself. It keeps agent work, approvals, project files, and terminal commands reachable from your phone.
OpenCode Mobile is not an official OpenCode product, a hosted AI service, or a replacement for the OpenCode server.
Choose your starting point
Section titled “Choose your starting point”| If you want to… | Start here |
|---|---|
| Understand what the app does | What is OpenCode Mobile? |
| Download the app | Download and install |
| Connect a server and finish a first task | Set up OpenCode Mobile |
| Manage servers, QR pairing, or Cloud Link | Add or switch connections |
| Learn the controls after setup | User manual |
| Fix a connection or feature problem | Troubleshooting |
The shortest safe path
Section titled “The shortest safe path”- Install the app from Google Play, the direct APK, or TestFlight.
- Start OpenCode 2 and pair on the machine that owns your project.
- Connect the app with a QR code, manual URL, or Cloud Link.
- Select a project and send a small, verifiable task.
If you only need the app on the same trusted network, the local network guide is the shortest route. For access outside your network, compare Tailscale, Cloudflare Tunnel, a reverse proxy, SSH, and Cloud Link.
Do a specific task
Section titled “Do a specific task”- Start and monitor a task — send work, follow progress, steer a running turn, and stop a bad direction.
- Manage chats and sessions — search, favorite, archive, restore, fork, or share work.
- Review approvals and changes — answer permissions and review Turn, Uncommitted, or Branch diffs.
- Use voice — dictate a prompt or run a hands-free conversation.
- Understand session usage — read context pressure, tokens, steps, and cost estimates.
- Work with project files — search, read, and save focused edits.
- Use the terminal — open a project PTY in the xterm-based terminal.
- Manage worktrees — isolate parallel work.
- Configure providers and models — connect AI providers and choose models.
- Manage MCP and diagnostics — inspect tools, realtime updates, and server health.
- Receive task notifications — completion and needs-input alerts.
- Share from another app — send text, links, and files into a chat on Android.
- Use quick actions and widgets — reach recent chats from the launcher or Android home screen.
Connect your way
Section titled “Connect your way”| Method | Best for | Guide |
|---|---|---|
| Manual URL | Any reachable server, including a VPN or tunnel | Connections |
| Local QR | Phone and computer on the same network (OpenCode 2) | Local network |
| Tailscale | Private access between your own devices | Tailscale |
| Cloudflare Tunnel | A public HTTPS address with your own tunnel | Cloudflare Tunnel |
| Reverse proxy | Existing HTTPS infrastructure or an API prefix | Reverse proxy |
| SSH forwarding | Advanced users with a mobile SSH client | SSH forwarding |
| Cloud Link | Managed remote access with a store subscription | Cloud Link |
Read the remote access security model before exposing a server beyond a trusted network.
How the pieces fit
Section titled “How the pieces fit”| Piece | What it is | Where it runs |
|---|---|---|
| OpenCode Mobile | The mobile client you install | Android or iOS |
| OpenCode server | The coding agent that owns your project | Your computer or server |
| Connection route | LAN, VPN, tunnel, proxy, SSH forward, or Cloud Link | Between the phone and server |
The app is a remote control. Your repository, provider credentials, build tools, and complete development environment stay on the machine that runs OpenCode.
Configure the app
Section titled “Configure the app”Use Settings and customization for connection profiles, AI providers, model visibility, notifications, voice, appearance, language, approvals, MCP, diagnostics, and update checks.
Fix a problem
Section titled “Fix a problem”- Troubleshooting — work from the server outward with a symptom-based checklist.
- FAQ — short answers about platforms, connections, file editing, sharing, widgets, and privacy.
- Releases and compatibility — current release, OpenCode 1.x/2.x support, and known limits.
For AI assistants
Section titled “For AI assistants”Use Documentation for AI assistants for canonical facts, machine-readable endpoints, and citation guidance. The site also publishes llms.txt, llms-full.txt, and raw Markdown for every page.