Your coding agent, in your pocket. Your server, under your control.
Start coding tasks, follow streaming answers, approve requests, and review changes from your Android phone. OpenCode Mobile connects to OpenCode running on your computer or on the phone itself through Termux.
Download for Android · Set up your connection · Watch the demo · Get help
Public alpha. Android is the primary target; desktop builds are experimental. OpenCode Mobile is an independent community project. It is not built, maintained, endorsed by, or affiliated with the official OpenCode team. It is built heavily with AI assistance. See compatibility and the release notes before installing. Report problems from More → Report a bug in the app.
You talk, it works, you watch. Answers stream in as they are written. When the agent reads files, edits them or runs commands, you see each step as it happens, grouped into one line you can expand ("Read 3 files, edited 1, ran 2 commands").
It asks before it does anything you might not want. A permission request appears as a small card right above where you type. One tap to allow it, another to look closer, and the keyboard never gets pulled away from you.
Diffs that fit a phone. Changes wrap to the screen, with a colour bar beside each line, so you can actually read what the agent did before you say yes.
Choices as buttons. When the agent offers options, they come as buttons you can tap, not a list you have to retype.
Your providers, recognisable. Providers show a favicon where available, with a monogram fallback, a clear connected state, and server-supplied model pricing in each model's options.
Your go-to models, a tap away. Star models in the picker and revisit your eight most recent choices in the Favorites and Recent tabs. These are saved for each server. The switch button beside the chat's model opens quick cycling; hardware keyboards can use F2 and Shift+F2. Changes made in a chat apply to that session's next turns.
Stay connected while Android permits. Turn on background mode and the notification becomes a live view of the run: which session, what the agent is doing right now, how many things need you. On Android 16 it shows as a live update. There is a Pause button in the shade.
Keep your next thought. Draft text saves as you type. The composer's + menu can reuse text from earlier prompts or clear the draft with Undo. Image attachments show thumbnails before sending; attachments themselves are not saved with the draft.
Let independent work continue. When the server supports it, a Background button appears for foreground subagents (and supported shells on OpenCode 2). Ctrl+B triggers the same action from a hardware keyboard. Running agents stay accessible above the composer. This work runs on the server and depends on that server remaining alive.
Open Running work to switch to a related agent or inspect a supported OpenCode 2 command. Read and copy its output, change its remaining timeout, or stop it with confirmation. Output follows while the viewer is visible; scrolling back pauses Follow so new output does not pull you away from what you are reading.
Find the tool you need. More groups destinations into compact rows and searches settings, models, providers, integrations, terminal, and help.
Share text into it. A stack trace, a link, a message. Share from any app and it opens a new session with that as your first prompt.
Talk instead of type. Voice input is transcribed on the phone. Audio never leaves the device.
Make it yours. Theme packs (OpenCode green, Catppuccin, Gruvbox, Solarized, or your phone's own Material You colours), light and dark, and a home-screen widget that shows your sessions.
| Welcome | Streaming answer | Permission card | Diff |
|---|---|---|---|
 |
 |
 |
 |
One searchable list, saved favorites, and quick switching inside each chat. These captures come from the installed app on an Android 16 emulator connected to a local OpenCode server.
| Browse models | Saved favorites | Switch this chat's model |
|---|---|---|
 |
 |
 |
| Linux desktop: Workspace | Linux desktop: Permission card | Linux desktop: Review |
|---|---|---|
 |
 |
 |
Full demo (51 s, 1080p, with sound): opencode-mobile-demo.mp4. Phone footage uses production widgets with sample data; the Linux desktop scene was recorded live.
The same demo as a video: video/public/demo.webm.
You need an Android arm64 device and either an OpenCode server you can reach or Termux on the same phone. Configure a model provider on your server before starting a task. The app supplies the interface; your server and provider do the work.
- Install the app. Grab the arm64 APK from the latest release. Android will warn that it is not from the Play Store. That is expected.
- With OpenCode 2 installed on your computer, start pairing.
It prints a QR code.
opencode2 pair
- Scan it in the app. Address, username and password fill in by themselves. Start talking.
No computer nearby? Tap Run OpenCode on this phone on the welcome screen and the app sets up OpenCode inside Termux for you. It takes ten to fifteen minutes the first time and needs two taps from you along the way.
Connecting over the internet, using an older OpenCode 1 server, or running the server as a service on a Linux box are all covered in the guide inside the app and in docs/technical-overview.md.
- OpenCode 1: use manual setup in the app;
opencode2 pairis for OpenCode 2. Follow the connection guide. - The address is
localhost: on a phone, that means the phone itself. For a computer-hosted server, use an HTTPS address reachable from the phone. - No models appear: configure a provider on the server, then use Refresh models in the model picker. If a connected provider is listed as unloaded, use Reload providers there.
- An APK will not update: check the signer notes below. Keep a copy of your connection details before uninstalling; uninstalling erases local data.
| Surface | Public-alpha status |
|---|---|
| Android | Primary target; arm64 sideload APK |
| OpenCode 1 | Supported against the current 1.18.x line |
| OpenCode 2 | Beta support targets the captured 0.0.0-beta-18600 contract; newer betas may differ |
| Linux x64 | Experimental; CI-built tarball and Debian package |
| Windows x64 | Experimental; CI artifact, no installer |
| iOS / macOS | Not available |
The client connects directly to a server you choose. It does not provide a hosted OpenCode account or model subscription.
This is an alpha. Here is what that means, plainly:
- Android is the real target. It is tested on devices and emulators, with more than 1,200 automated tests behind it.
- The Linux build has now been run, on a virtual display. It was launched on Xvfb at 1440x900 against a live OpenCode server and captured; see the Linux desktop screenshots above. Nobody has run the Windows build yet. If you try it, you are the first. Please tell us what happened.
- English only for now. The plan to change that is written down in docs/localization-todo.md.
- Public releases and CI artifacts are different channels. The current
v1.0.33+34release signer is8F51FBCA8101DE600C0E878DF7E2CC65DFA29ADD58A1771D776908349CD82053. Starting withv1.0.34+35, the recoverable permanent release signer is842284B27AA297FB74CF831779FD16498517E1BC2104451459FEC2EA7AC11D1C. Moving fromv1.0.33+34therefore requires one final uninstall. Android updates in place only when the package ID and signer both match. CI artifacts are test-only and may require uninstalling first, which erases local app data. Verify the installed signer in Settings → About. - Automated checks run in GitHub Actions on
masteranddev. Android CI uploads a short-lived, non-production APK to prove the release build compiles.
The app talks to the OpenCode server you choose and to nobody else about your work. Passwords live in Android's keystore. Voice stays on the phone. Provider logos are fetched from Google's public favicon service by domain name and nothing more. The full picture is in PRIVACY.md, also inside the app under Settings → Privacy and data use.
Everything technical lives one level down:
- docs/technical-overview.md — connecting in depth, the two server protocols, building, releasing, code layout
- CONTRIBUTING.md — the toolchain pin, the checks a change must pass, and the boundaries in the code
- SECURITY.md — how to report a vulnerability privately. This app holds server credentials and can approve shell commands. Never report a vulnerability in a public issue.
- SUPPORT.md — where a problem belongs: this app, the OpenCode server, your model provider, Termux, or Shorebird
MIT. The app bundles JetBrains Mono and Space Grotesk (both OFL-1.1), sherpa-onnx (Apache-2.0), ONNX Runtime and the Whisper models (MIT), and the packages listed in THIRD_PARTY_NOTICES.md. Built on the shoulders of the OpenCode team, who made the agent this app is a window onto.