What Is OpenCode Mobile?

OpenCode Mobile is a community-built mobile client for an OpenCode server. It keeps active coding work reachable from a phone without trying to turn a small screen into a full desktop IDE.

The app is distributed for Android through Google Play and direct APK releases, and for iOS through TestFlight. Start on the Download page, then connect it to an OpenCode server that you control. OpenCode 2 is the current primary target and supports the quickest setup through opencode service start and opencode pair. The client still detects and supports OpenCode 1.x (V1) servers with manual connections for the core surface.

What you can do

• Start, monitor, steer, stop, and continue OpenCode chats
• Switch between saved servers, server projects, worktrees, and sessions without losing context
• Favorite, rename, delete, fork, and revert sessions; jump back to the latest activity
• Review transcript activity, changes, diffs, todos, permissions, and questions
• Send prompts, attachments, shared content from other apps, slash commands, mentions, and shell commands
• Choose agents, models, variants, reasoning behavior, and per-agent model memory
• Let automatic model routing choose a model for each prompt
• Use voice dictation, on-device wake-word conversation mode, and spoken replies
• Receive completion and needs-input notifications on supported native builds
• Use quick actions and three Android home-screen widgets
• Inspect server health, realtime status, network behavior, MCP state, and app-error diagnostics
• Work with project files, media previews, file actions, worktrees, MCP servers, extensions, and an xterm-based project terminal
• Manage MCPs, plugins, agents, skills, and slash commands on OpenCode 2
• Open sandboxed plugin GUI panels inside the app
• Connect through a LAN, Tailscale, Cloudflare Tunnel, reverse proxy, SSH forward, OIDC, or optional Cloud Link

Main areas

Chat

Chat is the main operator surface. It includes the chat library, transcript, current activity, changes review, todos, model and agent controls, attachments, permissions, questions, and message actions such as fork, revert, and undo revert.

The chat library groups sessions by server and project and shows project paths. It opens from the current chat title. A change chip above the composer opens the review overlay; there are no separate Session and Files Changed tabs.

The composer supports server commands, @ mentions, and ! shell mode on OpenCode 2, plus the built-in /compact and /btw commands. On OpenCode 2, Steer and Append control whether a message sent during work applies at the next step or waits for a later turn.

OpenCode Mobile listens for global server events and uses polling as a fallback. A temporary event-stream interruption should not make an active task invisible. A prompt attempted while offline is queued and sent once after reconnect; an uncertain timeout is marked and never replayed automatically.

Projects

Projects keep chats, files, and terminal sessions tied to the repository selected on the OpenCode server. The picker lists the server’s projects in server order; it does not keep a separate local “opened” list. Depending on server capabilities, you can:

• Select a server project or add a directory through a folder browser
• Hide a project on this device, or restore a server-archived project on OpenCode 2
• Search and read text files, preview media, download files, and save focused edits
• Copy, move, rename, or delete files on OpenCode 2
• Inspect changed-file counts and the current VCS branch
• Create, select, and remove experimental worktrees

Terminal

Terminal connects to project PTYs through a short-lived server ticket and a project-scoped WebSocket. The xterm-based surface supports ANSI/VT cursor behavior, alternate-screen programs, 10,000 lines of scrollback, resize, reconnect, and a mobile keyboard accessory with Esc, Tab, modifiers, arrows, and paste.

It is still a mobile terminal, not a replacement for a desktop terminal workspace.

Settings

Settings is searchable and grouped into App preferences (Appearance, Chat & responses, Voice & audio, Notifications, Language, About & support), Connections (Connection, Cloud Link), and the Selected server (AI & providers, Extensions, Approvals, Diagnostics).

See Settings and customization for the complete map.

Connection model

The app can use:

• A trusted local-network address
• A local QR code created by opencode pair on OpenCode 2
• A private Tailscale HTTPS address
• A Cloudflare Tunnel address
• A reverse-proxy address, including a path prefix such as /api
• A loopback address backed by a separate SSH forwarding app
• A manual connection with custom headers, a custom CA, or OIDC
• An optional Cloud Link machine

Saved connection profiles let you switch servers without retyping the URL and password. See Add or switch connections and Remote access.

Important boundaries

• OpenCode Mobile is not an official OpenCode product.
• It is not a generic consumer chatbot or a replacement for a full IDE.
• On native iOS and Android builds, non-secret connection details use app storage and credentials use Keychain/Keystore-backed secure storage. Browser builds cannot persist credentials through native secure storage.
• OpenCode 1.x is supported for the core V1∩V2 surface. Archive/restore/share, title summarization, worktree reset, LSP/formatter diagnostics, and the composer auto-approve/saved-rules surfaces are not available.
• Extensions management, plugin GUI panels, media preview, file mutations, composer mentions/shell mode, and server-classifier routing require OpenCode 2.
• Cloud Link is an optional paid remote-access service available only in store-installed iOS and Android builds. Direct APK and web builds do not offer it.
• Android release artifacts are arm64-v8a only; 32-bit-only devices are unsupported.
• iOS inbound sharing and iOS home-screen widgets are not yet available; Android supports both.
• Older removed API shapes are not compatibility targets. Use a current OpenCode server and the latest mobile release.

The simplest mental model is: OpenCode runs the work; OpenCode Mobile is a focused control surface for it.

Recommended learning path

1. Follow Set Up OpenCode Mobile to install, connect, and run a first task.
2. Open Features and guides and choose the outcome that matches your situation.
3. Use the User manual for orientation, then open the focused guide from the sidebar.
4. Read Remote access before connecting outside your local network.