Skip to content

Run OpenCode on Your Phone (iPhone + Android)

One tap opens OpenCode in a cloud terminal. The first prompt runs on a free model.

Updated 4 min read Cosyra team

Cosyra Terminals screen with the OpenCode shortcut in the Your shortcuts row
OpenCode on a phone after writing hello.py and running it, printing Hello, World!
OpenCode Connect a provider list on a phone, showing OpenCode Zen, OpenAI, GitHub Copilot, Anthropic and Google

OpenCode runs on your phone through Cosyra for iPhone or Cosyra for Android. Cosyra gives the phone a cloud Linux workspace with OpenCode already installed. You tap the OpenCode shortcut, it opens in a terminal, and you can send a prompt straight away because OpenCode starts on a free model.

The steps and screenshots below are from the Cosyra 2.8.5 iPhone app, taken in October 2026. The flow is the same on Android.

What you need

Open OpenCode on a mobile device

Step 1

Install Cosyra and open Terminals

Install the app and sign in. It opens on Terminals. The row at the top is Your shortcuts: Claude Code, Codex, Antigravity (shown as Gemini CLI in app 2.8.5 and earlier) and OpenCode.

The chip next to the title shows your workspace. Sleeping means it is paused and costs you no hours. It wakes when you open a terminal.

Cosyra Terminals screen: workspace status, the Your shortcuts row and the Projects list

Step 2

Tap the OpenCode shortcut

Swipe the shortcuts row to the left and tap OpenCode. The workspace wakes up and OpenCode opens in a new terminal. There is no install step and no sign-in screen.

The line under the prompt shows the agent and the model: Build and Big Pickle, a free model from OpenCode Zen.

OpenCode start screen in a Cosyra terminal on a phone, on the Build agent with the Big Pickle model

Step 3

Send a first prompt

Tap the terminal to bring up the keyboard, type a request and press return. We asked for a hello world script in Python and for it to be run.

OpenCode wrote hello.py, ran it and printed the output in 9.1 seconds. The file is in your workspace home folder and stays there.

OpenCode wrote hello.py, ran python3 hello.py and printed Hello, World! in 9.1 seconds

Step 4

Connect your own provider

For real work you will want a stronger model. Type /connect and press return. OpenCode lists its providers, with the popular ones first:

  • OpenCode Zen and OpenCode Go
  • OpenAI, with a ChatGPT Plus or Pro plan or an API key
  • GitHub Copilot
  • Anthropic, with an API key
  • Google

Pick one and follow its sign-in. Then switch models with /models.

OpenCode Connect a provider dialog with Popular providers and a searchable full list

Typing in OpenCode on a phone

OpenCode expects keys a phone keyboard does not have. Cosyra adds a toolbar above the keyboard with Esc, Tab, Ctrl, Alt and the arrow keys, plus a microphone for dictation. The docs list every toolbar key.

Your session keeps running

The terminal lives in the workspace, not in the app. Lock the phone, take a call or switch apps and OpenCode carries on. When you come back the same session is on screen. You can also open the same workspace from another phone or a tablet.

To work in a repository, go back to Terminals, tap New and choose Open folder. Then start OpenCode from that folder.

Questions

Can you run OpenCode on a phone?

Yes. OpenCode needs a real Linux environment, and a phone does not give it one. Cosyra gives your phone a cloud Linux workspace with OpenCode already installed, so you tap the OpenCode shortcut and it opens in a terminal.

Do I need an API key to try OpenCode on mobile?

Not for the first prompt. OpenCode opens on Big Pickle, a free model served by OpenCode Zen. To use Claude, GPT or Gemini models, run /connect and sign in to that provider or paste its API key.

Does OpenCode work the same on iPhone and Android?

Yes. OpenCode runs in the cloud workspace, not on the phone, so the same shortcut, the same terminal and the same sessions are there on both.

Does my OpenCode session survive closing the app?

Yes. The terminal keeps running in your workspace when you lock the phone or switch apps. Open Cosyra again and the session is where you left it.

What does it cost?

Cosyra is a subscription: Core is $20 a month and Pro is $30 a month. Eligible new users can start a 7-day free trial in the App Store app. Model usage is separate and is billed by the provider you connect.