Skip to content

Releases: hi77x/opencode-android

OpenCode for Android v0.1.1

Choose a tag to compare

@hi77x hi77x released this 19 Sep 11:29

OpenCode for Android v0.1.1

Android 8.0+ (arm64-v8a). Download app-release.apk below and install it on your phone, or use adb install -r app-release.apk.

What the app does

The phone runs an embedded OpenCode server and agent. The existing packages/app web interface opens in a WebView over 127.0.0.1 on a port selected at startup. The Android host adds mobile styles, a read-only Files browser, and a Usage panel; the packages/app source itself is unchanged. A PC, Termux, root, and a remote OpenCode server are not required. A network connection and provider credentials are still needed for cloud models.

The APK includes git, rg, and a Bun runtime exposed as bun and node. Shell commands use /system/bin/sh. Git changes and syntax-highlighted diffs are available in Changes. The Android host supports selecting phone files through the system picker.

First launch and data

  1. Grant the requested all-files access if you want sessions, provider credentials, and project files under /sdcard/OpenCode/home. That directory survives app removal. Without the permission, the app uses private storage, which Android removes on uninstall.
  2. In Settings → Providers, connect a provider and enter its credentials.
  3. Select or create a project, such as ~/workspace, and start a session.

When shared storage is granted later, the host copies existing private HOME data to the shared location and restarts the server. The WebView's own local state is separate, so after reinstalling you may need to select the project again even though the session data remains on disk. Keep a backup of /sdcard/OpenCode before uninstalling if the data matters to you.

Current limits

  • No PTY terminal (bun-pty has no Android build).
  • LSP servers and formatters are not bundled for Android.
  • Local MCP subprocesses are not supported in this build.
  • The APK is for arm64-v8a only; there is no x86 or 32-bit build.

Source and build

Source tag caveat: the v0.1.1 tag currently points to an old upstream commit that predates the Android module. The Android source described here is on main (commit ad8a561). The tag's source archives cannot build this APK, and the uploaded APK has not been verified as a byte-for-byte build of that commit. Use the main checkout and docs/android/BUILD.md for the documented build steps. The build script produces a debug APK; the downloadable file on this page is a separate release APK.

This is an independent fork of anomalyco/opencode, licensed under MIT.