Repository navigation
OpenCode Android 5.0.1 is the maintenance release of the new 2.x edition,
an unofficial Android client for opencode.
It is not affiliated with, endorsed by, or sponsored by the upstream project.
This edition uses its own package (com.opencode.android, versionCode 175) and
installs side by side with the classic 4.x app. The signing key is unchanged,
so it installs in place over 5.0.x. The agent still runs entirely on the phone:
no Termux, no PC, no root required.
Highlights
- opencode runtime updates now work in v2. The app follows the 2.x release
branch, shows a notification when a newer runtime is published, and installs
it from the notification. - Post-update health check fixed. The updater reads the runtime version from
/api/infowith Basic auth, the endpoint used by the 2.x server, so a runtime
that starts correctly is no longer rolled back as "did not start". - Magisk 31.1+ root flow. The app detects the Magisk version, explains the
manual Superuser+grant, opens the root manager and rechecks the permission
when you return. - Bundled runtime: opencode 2.2.0. The in-app updater can move it to the
latest 2.x after install; the APK itself ships 2.2.0. - Channel-aware updates. v2 only offers 5.x app releases and opencode 2.x
runtimes. It never offers the v1 channel.
Verified
On an Android 15 arm64 device, installed over the previous 5.0.x build and
updated the runtime from the notification: download, SHA-256 verification,
install, server restart and health check all succeeded. The server reports the
new runtime version and runs from files/runtime/<version>/opencode. Existing
sessions and settings were preserved.
Known limitations
- Only Android 15 arm64 has been tested. Android 8-14 (including the legacy
storage fallback), other OEMs, tablets and 16 KB-page devices are untested. - The first run installs the npm dependencies and the package index.