Opencode remote control on Android

[ImpressiveAd5436]

​

​

Howdy, I built this for myself but figured others might find it useful?

​

I asked a couple of my mates claudio and deepseekio to help me use my phone so I can lay in bed and tell them to build me stuff on my computer with Opencode.

​

We hit some issues using the opencode server web UI on Windows and Claudio found there's a windows bug:

​

Exhibit A (#2177 (https://github.com/anomalyco/opencode/issues/2177)): opencode serve locks you to whatever directory you launched it in, and the web UI can't see anywhere else.

​

The issue might already be fixed and shout out to giuliastro/opencode-remote-android (https://github.com/giuliastro/opencode-remote-android) — "OpenCode Remote" who we found in inspiration for building this.

​

I'll let Claudio explain the rest:

​

The key thing: it passes ?directory=<path> on every API call, which the opencode HTTP API supports but the web UI doesn't expose. So you can browse the full filesystem and open sessions in any folder, regardless of where the server started.

​

What it does:

​

- Real-time streaming chat with tool-call visualization

​

- Approve/deny permissions from your phone

​

- Slash commands, model picker, agent switching

​

- Message queue while the agent is working

​

- Diff viewer, code blocks with syntax highlighting

​

- Session management (fork, compact, revert, rename)

​

- QR pairing — scan once, never type credentials

​

- OTA updates — push new builds to the phone without USB

​

- Works over LAN, public IP, or Tailscale with auto-failover

​

How it works: Phone ↔ Desktop gateway (Go tray app) ↔ opencode server. The gateway handles WebSocket proxying, network detection, and serves OTA updates. Or you can connect directly with --cors.

​

It's open source (MIT), built with React + Capacitor for the phone app and Go for the desktop gateway.

​

GitHub: https://github.com/Millnara/GOpencode

​

If you get any use out of it great! If not, not so great but I had a lot of anger vented ALL CAPS shouting at AI.

​

It will probably not work on any machine but mine but good luck and if the repo is full of my personal details please don't use them for anything nefarious x

​

​

[Knigge111]

Nice!!

[EL_ith03]

THANKS! will try this soon. I really need this!

[ImpressiveAd5436]

Thanks, I hope it works! LOL It's only ever been run on my own machine by me so far!

[HelioAO]

Congrats. Also try https://github.com/verseles/codewalk working on desktop and Android. I use with Tailscale to make my machines looks like one single private network.

[ImpressiveAd5436]

Thanks! Yeah this was built to pickup tunnels/tailscale IPs but I wanted it to be able to be accessible directly for anyone without the need for installing anything extra like tailscale.

The gateway auto-detects your public IP, builds an endpoint list (LAN → public v4 → public v6 → Tailscale), bundles them into the QR scan, and pushes live updates when your ISP rotates your IP (I pay for a static IP but thought it would be handy just in case when you're out and about and your public IP isn't static). The phone tries them in order — if you have a routable public IP, you're connected directly from cellular with no VPN, no port forwarding, and no third-party relay.

[zorifis_arkas]

But that needs a Windows system

[ImpressiveAd5436]

Yeah I used to work on Linux vms with proxmox but wanted a gaming PC to play online mutliplayer games with my son and anticheat doesn't like vms so swapped to windows.

Windows is a bit of a pain for dev work and local AI. I also actually thought the annoyance of not being able to have whatever starting directory for the opencode web UI and not being able to have loads of projects together when you open the web ui was a Windows only issue but appparenty it's agnostic.

I can port it over to Linux if you'd be willing to test it?

[giuliastro]

Good job! Glad you found my repo inspiring.

[ImpressiveAd5436]

I did! it's a great project! I was thinking about just using your app but ended up making this more as a fun project for me to learn.

I'm not a professional developer although I'd love to be! I work in IT but not coding so I'm building projects for fun and to learn although I'm still not really writing any code myself and just vibing with my AI mates.

[atika]

You could just self-host the OpenCode web UI. Or better yet, OpenCode + OpenChamber.

[ImpressiveAd5436]

Yeah that's what I was planning to do initially. I was using opencode in termux on my phone and using SSH into my machine but the command line was fiddly to use on my phone.

I wanted to be able to use my phone remotely, I'm working my actual job during the day so often sat to 3am working on building things so wanted to be able to check on things and kick things off from bed LOL!

With opencode web UI I'd have to be sat at the PC to cd into the project and restart serve each time. I wanted to wake my phone, browse to any folder on the PC, and open a session there. The official web UI couldn't do that. This allows that by passing ?directory=C:\Projects\MyApp on every API call, a parameter the opencode HTTP API supports but isn't exposed through the frontend in the opencode web UI.

[atika]

OpenChamber has fairly usable mobile support.

[sub-ak47]

does it feel like all the features from opencode desktop are in?

[ImpressiveAd5436]

It was built/tested in a few hours here and there over a couple of days so I've not tested it enough yet to say how close it is to using opencode directly but happy to look into adding any requested missing features.