Run OpenCode on Your Phone (iPhone + Android)

You can run OpenCode on your phone today. Fastest path: install Cosyra for iOS or Cosyra for Android, sign in, and type opencode in the terminal. We pre-install OpenCode in an Ubuntu 24.04 x86_64 container alongside Claude Code, Codex CLI, and Gemini CLI, so none of the Termux misdetection failures apply. Sign up gets you 1 hour of free compute, no credit card; opt into a 10-hour, 7-day trial when you want more.

This guide was written by the Cosyra team. We tested OpenCode on iPhone and Android via Cosyra in April 2026, and re-ran the Termux setup against OpenCode 0.21.x to confirm what is still broken. Where we make claims about OpenCode itself, they are dated 2026-04-27 and cross-checked against the anomalyco/opencode repo and the official docs.

What is OpenCode?

OpenCode is the open-source AI coding agent maintained by Anomaly (the project moved from sst/opencode to anomalyco/opencode; GitHub still redirects the old URL). It ships under MIT, with about 149,000 stars on GitHub as of late April 2026. The codebase is mostly TypeScript with a small Rust component, distributed as prebuilt binaries via npm optionalDependencies, one binary per platform and arch combination.

The pitch versus the closed agents is the license, the lack of vendor lock-in, and the headless server mode. OpenCode brokers Anthropic, OpenAI, Google, and local models behind a single TUI; opencode serve starts a headless HTTP server you can drive from an IDE plugin, a script, or (relevant here) a phone. The README explicitly notes you can run the server "on your computer while you drive it remotely."

How can you run OpenCode on a phone?

You can run OpenCode on a phone three ways: a cloud Ubuntu container with OpenCode pre-installed reached from a native mobile app (Cosyra), Termux on Android via the proot-distro workaround, or Blink Shell on iOS into a VPS where you install opencode yourself. OpenCode needs a real Linux or macOS shell with the right binary for the right arch, so every approach puts the actual opencode process somewhere else and gives your phone a way to drive it. All three are current as of 2026-04-27.

1. Cosyra: cloud Ubuntu container, OpenCode pre-installed

This is what we built. A native iOS and Android terminal that connects to a persistent Ubuntu 24.04 x86_64 container in the cloud. OpenCode, Claude Code, Codex CLI, and Gemini CLI are already on the image against a current Node 20+. You sign in, run opencode auth to connect your provider once, and type opencode.

• Works when: you want zero setup, both iOS and Android from the same container, and you do not want to debug npm optionalDependencies resolution on your phone.
• Breaks when: you have no internet (the container lives in the cloud), or you need to reach a private network we do not route through. Honest trade-off list in Cosyra vs Termux.
• Cost: 1 hour free on signup, no credit card. Extend with a 10-hour, 7-day trial when you want more, then $29.99/month. You pay your provider for OpenCode tokens; OpenCode itself is free. See pricing.

2. Termux on Android, via proot-distro

Install Termux from F-Droid (the Play Store build returned in June 2024 as a separately-versioned Android 11+ build, but most install guides target F-Droid), then install proot-distro and run a Debian or Ubuntu chroot inside Termux. Inside that chroot, install Node 20+ and npm i -g opencode-ai. Why the chroot? Two open OpenCode issues. Issue #21043 says the launcher misdetects the Termux environment as plain Linux and pulls the wrong arch binary; PR #21106 has been in-flight to remove the hard-exit but was not merged as of 2026-04-25. Feature request #22805 asking for native Termux support was closed without a maintainer commitment.

• Works when: you are on Android, you accept the proot-distro overhead, and you want a fully local setup with no cloud bill.
• Breaks when: a new OpenCode release ships changes that break the chroot path, or Android 12+'s phantom process killer terminates a long agent run. The misdetection bug is the headline; PR #21106 may improve things, but it has not landed.
• Cost: free OpenCode binary, free Termux, free proot-distro. The cost is your time when the install path breaks between releases.

3. SSH from Blink Shell into your own VPS (iOS only)

On iPhone or iPad, Blink Shell is the gold-standard SSH client. Spin up a VPS (Hetzner, Scaleway, DigitalOcean), npm i -g opencode-ai on it, SSH in from Blink inside a tmux session, and run opencode. Authenticate with opencode auth or by exporting your provider key. You can also point Blink at opencode serve over a tunnel if you prefer the HTTP API to the TUI.

• Works when: you want a box that is yours and an iOS-native keyboard. Polished terminal UX on iPhone.
• Breaks when: you do not want to be a sysadmin. Patching, hardening, firewall rules, and backups are not optional on a box that holds your source code and your provider keys.
• Cost: Blink Shell is $19.99/year, the VPS is $5 to $40/month. No Android equivalent; Blink is iOS-only. Trade-off detail in Blink Shell alternative: Cosyra for iPhone terminals.

How do you set up OpenCode on iPhone or Android?

You set up OpenCode on iPhone or Android in about three minutes with Cosyra: install the app, sign in, confirm opencode is on the PATH, run opencode auth to connect a provider, clone a repo, run opencode. No Node install, no npm, no Termux misdetection.

Step 1: Install Cosyra and sign in

Download from the App Store or Google Play. Sign in with Apple, Google, or email. On first launch we provision a fresh Ubuntu 24.04 x86_64 container.

Step 2: Confirm OpenCode is there

No install step. OpenCode is baked into the image. Verify in one command.

Step 3: Connect a provider

Run opencode auth and pick the provider you want. Anthropic, OpenAI, Google, and local backends are all in the list. The flow opens a URL; sign in on your phone browser, paste the verification code back into the terminal. Keys persist with your container's home volume, so you do this once per provider per container.

Step 4 (optional): Use an env-var key instead

If you would rather not run the auth flow, export a provider key directly. OpenCode reads ANTHROPIC_API_KEY, OPENAI_API_KEY, and similar.

Step 5: Run your first OpenCode session

OpenCode reads the repo, proposes diffs, and waits for your approval before writing. The default build agent has edit access; the plan agent is read-only if you want to think before touching code. Both ship in the box.

What does an OpenCode session on a phone look like?

OpenCode's specific phone unlock is the multi-provider switch on a flag (--model anthropic/claude-3.7 vs --model openai/gpt-5) plus the headless server mode. Three real sessions we run from a phone.

Compare two providers on the same task, on the train

You have a tricky bug. Open Cosyra, cd in, opencode --model anthropic/claude-sonnet-4-6, paste the failing test plus the suspect file, ask for a root-cause. New session: opencode --model openai/gpt-5, same prompt. Cross- check the answers. The unification under one CLI is what makes that fast.

Drive `opencode serve` from Blink on a VPS

On iOS, the Blink-plus-VPS path lets you run opencode serve headless and hit it from a separate Blink pane via the HTTP API. Useful when you want a long-running session that survives SSH reconnects. We do not host the serve mode for you on Cosyra; that is squarely a Blink+VPS workflow.

Read-only repo audit from the couch

Saturday, you are curious about a repo a coworker shipped Friday. opencode --agent plan launches the read-only plan agent. Ask it to summarize the repo, list the riskiest files, and propose what you would change. No write access, no accidental edits.

What are the real limits of running OpenCode on a phone?

The real limits are no offline mode, the Termux path is rough, opencode serve is on you to host, and your provider's rate limits still apply. Knowing where OpenCode stops helps you match it to the right job.

• No offline mode. The container and your provider both live in the cloud. No internet, no OpenCode. If you code on planes with no wifi, this is not the right tool for that slot.
• Termux is rough today. The launcher misdetects Termux as Linux (issue #21043, open). The native-Termux feature request (#22805) was closed without a commitment. PR #21106 to remove the hard-exit is in flight but unmerged. proot-distro works but is not pleasant.
• You host `opencode serve` yourself. The headless server mode is great, but Cosyra runs the TUI in your container, not the HTTP API on a public address. If you want the API, run it inside your container and reach it via the same Cosyra session.
• Provider rate limits are yours. OpenCode is just the agent; the rate-limit and billing relationship is between you and Anthropic / OpenAI / Google. We do not proxy or meter that.
• No Docker-in-Docker guarantee. If your project's tests need docker on the host, verify before committing to phone-only.

How does Cosyra compare to Termux+proot and Blink+VPS for OpenCode?

Cosyra wins for zero-setup, dual-platform, and skipping the Termux misdetection bug; Termux-plus-proot wins if you want a fully local setup and accept the chroot overhead; Blink-plus-VPS wins on iOS if you want a box you own and you want to run opencode serve. None is strictly best; each maps to a trade-off. Comparison as of 2026-04-27.

For the broader picture across all four AI agents on mobile, see our pillar guide on AI coding agents on mobile. Same walkthrough with Anthropic's tool: Claude Code on phone; OpenAI's: Codex CLI on phone; Google's: Gemini CLI on phone.

Frequently asked questions