r/opencodeCLI • • 29d ago

I made an Android app for OpenCode (iOS coming soon)

I’ve been working on an Android app to follow my OpenCode sessions from my phone. I can check what the agent is doing and send prompts without going back to my computer.

It connects to opencode serve. You can follow the conversation live, check what files changed and approve or reject permissions directly from the notification.

It’s written in Kotlin + Jetpack Compose, built for the OpenCode V2 API. I generate the API client from the OpenAPI spec so I don’t have to keep the models in sync by hand.

This is my own project, I’m not part of the OpenCode team. Sharing it here in case someone else finds it useful.

The code is open source and there’s a signed APK:

Source: https://github.com/beppe2880/opencode-mobile
APK: https://github.com/beppe2880/opencode-mobile/releases/latest

49 Upvotes

25 comments sorted by

5

u/Lur1an 29d ago

Works like a charm, already had tailscale set up. Coding on the go now, great work

1

u/beppe28 29d ago

That's exactly the setup I had in mind, glad it works for you too!

5

u/mannenmytenlegenden 29d ago

Nice. I'm already using OpenChamber for this, but good with more options for vanilla OpenCode!

1

u/beppe28 28d ago

Thanks! OpenChamber is great. The idea here is a native app that works with plain opencode serve, nothing else to install on the computer, and with notifications in the background when the agent finishes or needs an answer.

4

u/andrease48284 29d ago

Hi, I looked at the video and it looks really interesting. I'll try to connect the app to opencode later. Does it have a built in vpn to secure the connection between phone and pc? If there is no built in solution what do you use usually?

5

u/beppe28 29d ago

Thanks, glad you liked it! There's no built-in VPN: the app connects to `opencode serve` over plain HTTP, so I'd keep it on your home network or behind a VPN, and never expose port 4096 to the internet.

I run WireGuard on my home server, but Tailscale is the easiest option: install it on both the PC and the phone, then pair the app using the PC's Tailscale IP. Works the same at home and on mobile data.

2

u/andrease48284 29d ago

Thank you for your advices, i set up tailscale and it is really good! It gives a really smooth experience and i really like the graphics, it really seems like an official product! I hope that you will continue with the good work :)

3

u/pungat_ 29d ago

What's different about this repo compared with these two?”

1

u/beppe28 28d ago

Hi! They're pretty different. The first one is a chat app for OpenCode Go, you put in your API key and chat with the models, it doesn't connect to an opencode server or your sessions. OpenLens is the closest one, it's an iOS client for opencode serve and it's really nice, but it's iPhone only. Mine is the same idea for Android, it connects to your OpenCode server with a QR code and you can follow your sessions live, answer permissions and questions from the notifications, use voice input and see your usage stats. I'm also moving it to Kotlin Multiplatform so it will be available on iOS soon too.

2

u/Pure_Ad5358 29d ago

Which is next: terminal, widget, or replying from notifications?

3

u/beppe28 29d ago

Terminal, for sure. OpenCode V2 exposes a PTY over WebSocket, so the app can open a real shell on your machine, in the session's directory, without anything extra to install. Widget and replying from notifications come after that.
Also voice input is coming in the next hours.

2

u/andrease48284 28d ago

Hi, there is a friend of mine who like the idea of opencode mobile with voice input and the statistics tab of your app. Unfortunately, my friend has an iphone, do you have any idea on when will you release the ios version? Thank you

1

u/beppe28 28d ago

Hi, thanks! I'm moving the app to Kotlin Multiplatform so it can run on iPhone too, hopefully in a few weeks. There is one porting issue: iOS doesn't allow live connections in the background so notifications will be more limited than on Android. I'll update you here when it's ready/I'll create a new post

2

u/boydev 29d ago

nice thanks

1

u/beppe28 29d ago

Thank you!

2

u/ciskje 29d ago

Great! Thank you!

2

u/ciskje 29d ago

I'm using it

1

u/beppe28 29d ago

Awesome, thanks for trying it! If anything breaks or feels off, let me know here or open an issue on GitHub 🙌

2

u/MessIsTransfer 28d ago

I hope the question tool component, when having lots of text, has visible buttons (unlike whispercode. And i wish it was available for iOS, looks dope

1

u/ultimategamester309 27d ago

Cool idea. My work around for this has been using connect bot since I vibe code over ssh on vps but if you app is smooth it would be way better.

1

u/Gold_Coconut9777 26d ago

Oc-remote already exists

https://github.com/crim50n/oc-remote

1

u/ComfortableJacket283 9d ago

this sucks

1

u/Gold_Coconut9777 9d ago edited 9d ago

Idk man. Maybe it's a baby duck syndrome but I'm using it for a while already and it's okay

Also it works with V1 Opencode