Repository navigation
OpenCode Android 4.0.2
OpenCode Android 4.0.2 is an unofficial Android client for
opencode. It is not affiliated with,
endorsed by, or sponsored by the upstream project.
Maintenance release for the classic app (com.opencode.launcher.next,
versionCode 174). It installs in place over 4.0.x: sessions, projects, runtime,
settings and the root grant are preserved. The agent still runs entirely on the
phone: no Termux, no PC, no root required.
Highlights
- Faster, smoother startup. The splash now waits until the web UI has
actually painted instead of disappearing ononPageFinishedand leaving a
black screen. A small early script warms the provider list and project git
metadata before the main bundle runs. - No more multi-second stall when opening a session. The runtime creates
its git repository beforeopencode serve, so the file watcher no longer
scans the filesystem root. - Runs side by side with v2. The internal toolbox port now derives from the
server port (4198 for v1, 4199 for v2), so both editions can run at the same
time without fighting over a socket. - Bundled runtime: opencode 1.19.4. The in-app updater can move it to
1.19.5 (or newer 1.x) after install; the APK itself ships 1.19.4. - Channel-aware updates. v1 only offers 4.x app releases and opencode
1.x runtimes. The v2 channel is never offered from this app. - Retry button follows the app language (Spanish/English), and the app
label is now simply OpenCode Android.
Verified
On an Android 15 arm64 device, installed over 4.0.1 as an in-place update:
same app id (10717), versionCode 174, existing projects and sessions intact,
server healthy on 4098 and toolbox on 4198. With v2 also running on 4099/4199,
both servers and both toolboxes stayed up simultaneously.
Known limitations
- Only Android 15 arm64 has been tested. Android 8-14, other OEMs, tablets and
16 KB-page devices are untested. - The Android 8-10 storage fallback compiles but has not run on real hardware.
- SSID/BSSID need location, which is not requested.
dumpsys wifi,settings
andip/ifconfig/netstatstill need root. - Root is optional. On Magisk, Superuser access must allow apps (not ADB-only);
otherwisesuis hidden from the app namespace even thoughadb shell su
works. - First run needs internet (npm dependencies and the package index). Low-RAM
phones may see the server killed in the background.