OpenCode Mobile Documentation
OpenCode Mobile is a community-built Android and iOS client for an OpenCode server that you run yourself. This documentation covers installing the app, connecting it to your server, configuring providers, securing remote access, and fixing connection problems.
OpenCode Mobile is not an official OpenCode product, a hosted AI service, or a replacement for the OpenCode server.
Start here
Section titled “Start here”- Download OpenCode Mobile — Google Play, direct APK, or the iOS TestFlight beta.
- What is OpenCode Mobile? — the client, its main screens, and its limits.
- Set up OpenCode Mobile — the shortest safe path to a first completed task.
- OpenCode Mobile app setup and download — requirements and connection options.
- User manual — the navigation hub for operating the app.
Do a specific task
Section titled “Do a specific task”- Choose a workflow guide — start with the outcome you need.
- Start and monitor tasks
- Manage sessions
- Approvals and changes
- Voice mode
- Understand session usage
- Work with files
- Use the terminal
- Manage worktrees
- Providers and models
- MCP and diagnostics
- Task notifications
Reach your server
Section titled “Reach your server”- Remote access overview — compare LAN, Tailscale, Cloudflare Tunnel, reverse proxy, and SSH forwarding.
- Use OpenCode from your phone
- Connect with Tailscale
- Connect with Cloudflare Tunnel
- Secure remote access
- Mobile vs web
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 machine |
| Connection route | LAN, VPN, tunnel, proxy, or SSH forward | Between the two |
The app is a remote control. Your repository, provider credentials, build tools, and complete development environment stay on the machine that runs OpenCode.