OpenCode Mobile

Your OpenCode workflow, in your pocket.

Start tasks, check progress, review changes, use the terminal, speak follow-ups, and manage OpenCode workspaces from Android and iOS.

Website · Docs · Support

---

OpenCode, without being tied to your laptop

OpenCode Mobile is an independent, community-built mobile companion for OpenCode.

It connects to the OpenCode server you already run and gives you a focused mobile control surface for the moments when you need to check, guide, approve, or continue agent work away from your desk.

It is not trying to put a desktop IDE on a smaller screen.

It is designed around the things that actually matter on mobile.

opencode-mobile-promo-2026.mp4

What you can do

• Run sessions from your phone — pick a project, worktree, agent, and model, then send, fork, or revert prompts.
• Follow progress live — reasoning, tool calls, shell output, patches, and todos, with notifications when you're needed.
• Approve, review, and edit — answer permission requests, inspect diffs, browse files, and open terminals.
• Talk to it — dictate prompts, read replies aloud, or use hands-free conversation mode.
• Shape your setup — providers, models, MCP servers, agents, commands, plugins, and visualizations like Flowgraph.
• Manage and personalize — multiple servers, projects, and sessions; themes, languages, text size, and widgets.

How it works

Your code stays on the machine running OpenCode.

OpenCode Mobile connects to that server remotely:

Your phone
    │
    │ HTTPS / secure tunnel
    ▼
OpenCode server
    │
    ▼
Your workspace + models

A typical setup looks like this:

1. Start OpenCode

opencode serve --port 4096

2. Expose it securely

Keep the server protected with authentication and connect through a secure HTTPS tunnel, VPN, or reverse proxy.

For example:

cloudflared tunnel --url localhost:4096

Tailscale, Cloudflare Tunnel, and other secure networking options work well.

3. Connect from OpenCode Mobile

Enter the protected server URL in the app, authenticate, choose your workspace, and continue your sessions.

For the complete setup flow, see the Getting Started guide.

4. Connect an AI provider

Open Settings → AI & providers → Add provider, choose your provider, select API key if multiple login methods are offered, paste the key, and save. For OpenCode Go, choose OpenCode Go and paste the key from your OpenCode console. You can then enable its models and select one in Chat. Tap an already configured provider to reopen login or replace its key.

Provider keys are saved on the connected OpenCode server. On OpenCode 2, the server's integration catalog determines which providers support API-key or OAuth login; environment-only providers must be configured on the server.

Install

Android

Recommended:

Download from Google Play →

Or install the latest APK directly:

Download latest APK →

iOS

OpenCode Mobile is currently available through TestFlight:

Join the iOS beta →

For installation details and requirements, visit:

getopencode.app/download →

Privacy and control

OpenCode Mobile is designed around self-hosted OpenCode environments.

• Your source code remains on your OpenCode host.
• The app connects to infrastructure you control.
• Server credentials are stored using secure device storage where appropriate.
• You choose how your OpenCode instance is exposed.
• No hosted OpenCode server is required.

For remote access, prefer authenticated HTTPS, a VPN, or a secure tunnel rather than exposing an unauthenticated OpenCode port directly to the internet.

Community-built

OpenCode Mobile is not an official OpenCode product. It is not built by the OpenCode team, is not endorsed by them, and is not affiliated with them in any way.

It is an independent open-source project built for people who already use OpenCode and want to keep their agent workflows reachable when they step away from their desk.

OpenCode and its trademarks belong to their respective owners.

Development

OpenCode Mobile is built with:

• React Native
• Expo
• TypeScript
• Expo Router
• @opencode/client for native OpenCode 2; @opencode-ai/sdk isolated to OpenCode 1 compatibility

For local development, architecture, testing, and release instructions:

Read the development guide →

For the full documentation map, architecture, product behavior, design system, and decisions:

Browse the documentation hub →

Reusable UI primitives and shared controls are catalogued in Storybook:

npm run storybook

Contributing

Contributions are welcome.

You can help by:

• opening bug reports
• proposing features
• improving documentation
• testing Android and iOS builds
• submitting pull requests
• helping reproduce compatibility issues with new OpenCode releases

Read the contributing guide, Code of Conduct, security policy, and support guide. Browse the issue tracker or open a PR.

⭐ Star History

❤️ Support Us

OpenCode Mobile is free and open source.

If the project is useful to you, you can help support continued development, testing, releases, and infrastructure through:

• GitHub Sponsors
• Ko-fi
• PayPal
• Bitcoin
• Ethereum

Support Us →

Made with contrib.rocks.

---

Take your next OpenCode session with you.

getopencode.app