Can I run OpenCode on my phone?

Yes. Shellular gives OpenCode a dedicated mobile UI with slash commands, @ file mentions, permission approvals, and model controls, all driving OpenCode running in your real project on your own machine.

Do I need to sync my project to my phone?

No. Shellular connects to your actual machine, a PC, Mac, Mac mini, or VPS, so OpenCode works on your real files with your real toolchain. There is nothing to sync or copy, and the agent keeps full context of your codebase.

Can I run tests and use Git from my phone?

Yes. You get a real shell, so you can run the test suite, review the diff in the file browser, and commit and push, all from your phone.

Yes. Shellular sessions are end to end encrypted. Traffic passes through a relay server, but it is encrypted on your machine and only decrypted on your phone, so the relay cannot read your code. The encryption key is shared by QR code and never leaves your devices, and you approve every new device.

How to Run OpenCode on Your Phone or Mobile (2026 Guide)

OpenCode is a terminal first agent, and that is exactly why it travels so well. Running OpenCode on mobile sounds tricky, but if something runs in your terminal, you can reach it from your phone. No special mobile build required, just a way to get to the shell OpenCode is already running in.

Shellular is that way in. OpenCode keeps running on your own computer, your PC, your Mac, a Mac mini, or a VPS, so it has full context of your real codebase, dependencies, and tools. And your phone does not just get a raw terminal, it gets a real, mobile-optimized UI for OpenCode.

Get going in minutes

Install Shellular on iPhone or Android.
Run the Shellular companion on your machine. The docs have the commands.
Scan the QR code to pair. The key never leaves your phone.
Open OpenCode in the app and start prompting.

Now OpenCode is running in your real project, with your real toolchain, driven from a UI built for your thumbs. Nothing synced, nothing faked.

The controls, built for your phone

Slash commands. Type / and pick from OpenCode's commands.
@ file mentions. Tap @ to pull a real file from your repo into the prompt.
Permission approvals. Approve or deny what OpenCode wants to run, with a tap.
Model picker and reasoning effort. Tune how OpenCode works without leaving the app.
Real terminal, files, and Git one tap away when you want to take over.

A practical example: OpenCode finishes a change and you want to confirm it before committing. From your phone you run the test suite in the terminal, watch it pass, eyeball the diff in the file browser, then commit and push. Done, without opening your laptop.

Why this beats a read-only viewer

A lot of mobile agent tools are read-only. They show you output but cannot run anything. The moment you need to fire a slash command, approve a permission, or fix a flaky service, you are stuck. Shellular gives you the real OpenCode UI plus a touch-friendly shell, so you are never just watching.

Is it secure?

Yes. Sessions are end to end encrypted. Traffic passes through a relay server, but it is encrypted on your machine and only decrypted on your phone, so the relay just forwards bytes it cannot read. The encryption key is shared by QR code and never leaves your devices. See the security overview for the details.

Bottom line

OpenCode and a phone are a natural pair, and Shellular makes it feel native rather than a workaround. You get a real OpenCode UI, with slash commands, @ mentions, permissions, and model controls, plus the terminal, files, and Git behind it. Pair once and your whole OpenCode setup fits in your pocket.

Run more than one agent? See Claude Code on your phone and Codex on your phone.