opencode-native-termux
v0.1.2
Published
Install OpenCode natively on Termux (Android) — no proot, no containers. Official opencode binaries bridged to Termux's native glibc.
Downloads
109
Maintainers
Readme
Requirements
- Termux from F-Droid (Play Store builds are outdated)
- aarch64 (ARM64) device — the only architecture OpenCode ships a Linux build for
- An internet connection for the ~60 MB download
Installation
One line — zero prerequisites:
curl -fsSL https://raw.githubusercontent.com/rexroze/opencode-native-termux/main/install.sh | shOr via npm (needs nodejs first):
pkg install nodejs-lts
npm i -g opencode-native-termux[!TIP]
opencodeis on your PATH immediately — the first run downloads the official binary (~60 MB), verifies its sha256 checksum, and configures your shell (bash, zsh, or fish).
Usage
opencodeRun /connect inside the TUI to add your AI provider — or start with the
free models that ship out of the box. Upgrades, shell setup, and
troubleshooting: docs/FAQ.md.
Blank screen? (plugins)
If the TUI shows a blank screen, it's almost always an opencode plugin in
~/.config/opencode/plugins/. opencode >= 1.15 tries to install its own
plugin runtime (@opencode-ai/plugin) with a bundled npm when plugins
exist — that in-process install deadlocks on Termux, and opencode waits on
it forever. The installer already pre-seeds the runtime with a real npm
install, so this should not happen after installing/upgrading. If it does,
or you added a project-local plugin (.opencode/plugin.js), fix it with:
sh install.sh --seed ./.opencode # or any dir that contains pluginsHow it works
OpenCode ships as a glibc binary; Termux runs on bionic. This project
bridges the two with Termux's native glibc package — official upstream
binaries, nothing patched, nothing emulated. The launcher runs the binary
through a loader symlink named opencode, so agent runtimes (herdr, ...)
that identify agents by kernel process name see opencode — not a glibc
loader. Full technical deep dive:
docs/HOW-IT-WORKS.md.
Links
- docs/FAQ.md — shell setup, upgrading, troubleshooting
- docs/HOW-IT-WORKS.md — technical deep dive
- opencode — upstream project
- LICENSE
