opencode for Termux — native Android build (Bionic aarch64)

opencode, the open-source AI coding agent, running natively on your Android phone through Termux. No proot, no chroot, no VM, no root, no glibc. One self-contained binary, a signed apt repository, three channels.

Screenshots

Native TUI, rendered on-device — no proot, no VNC, no WebView:

Free models are in the picker too — you can start coding without paying for anything.

Install

Pick a line, paste one command inside Termux:

Stable (1.x — default) — copy, paste, run:

curl -fsSL https://raw.githubusercontent.com/bd-loser/opencode-bionic/main/repo-setup.sh | bash

Beta (2.x — recommended for v2):

curl -fsSL https://raw.githubusercontent.com/bd-loser/opencode-bionic/main/repo-setup.sh | OPENCODE_CHANNEL=beta bash

Dev (2.x — bleeding edge):

curl -fsSL https://raw.githubusercontent.com/bd-loser/opencode-bionic/main/repo-setup.sh | OPENCODE_CHANNEL=dev bash

The script installs the signing key, points apt at this repo, and installs opencode. From then on pkg upgrade opencode keeps you current. Prefer typing the commands yourself?

curl -fsSL https://bd-loser.github.io/opencode-bionic/opencode-bionic.gpg \
  -o $PREFIX/etc/apt/trusted.gpg.d/opencode-bionic.gpg
echo "deb [arch=aarch64] https://bd-loser.github.io/opencode-bionic stable main" \
  > $PREFIX/etc/apt/sources.list.d/opencode-bionic.list
pkg update && pkg install opencode

To switch lines — say, 1.x to v2 — rerun the one-liner for the other line (it rewrites the sources entry and installs across downgrades), or edit the suite (stable/beta/dev) in $PREFIX/etc/apt/sources.list.d/opencode-bionic.list yourself. The package is opencode on every line.

Channels

All lines build automatically from upstream — an hourly watcher mirrors upstream moves, at most about an hour behind, one release per upstream version:

Channel	Tracks	Releases
stable (default)	upstream release tags	tags
beta	upstream beta branch	prereleases
dev	upstream dev branch	prereleases

New to opencode, or on 1.x and curious about v2? v2 ships on the beta and dev lines — beta is the recommended start. Live package index: bd-loser.github.io/opencode-bionic.

How it compares

Hope2333/opencode-termux and guysoft/opencode-termux also ship native-Bionic OpenCode and both have bigger communities than this repo. What is different here:

	opencode-bionic	Hope2333/opencode-termux	guysoft/opencode-termux
libc	native Bionic	native Bionic	native Bionic
release lines	stable + beta + dev, built automatically from upstream	v1 + v2	v1 + v2 side-by-side
dev freshness	tracks upstream commits hourly	—	—
terminal sessions (PTY)	works, bun-pty rebuilt for Bionic	—	—
what you install	one self-contained .deb	one of five package families	package + wrapper + libs
exact pinning	by version or upstream commit, curl or apt	—	—

Blank cells: not verified, read their README.

What is opencode?

An open-source, terminal-based AI coding agent — MIT-licensed and model-agnostic (Anthropic, OpenAI, OpenRouter, local models via any OpenAI-compatible endpoint). Developed at anomalyco/opencode with prebuilt binaries for macOS, Linux, and Windows — but none for Android. This repo provides the Android line.

Why a separate build is needed

opencode's TUI runs on opentui, a native Zig library. Upstream ships only glibc binaries; Android's Bionic linker rejects them. This project assembles the three pieces that make opencode run on Bionic:

• a Bun runtime patched for Bionic (SELinux-safe JIT, syscall traps, shebang remap, FFI paths),
• opentui rebuilt for android-arm64, published as @androidtui/* npm packages (16 KiB-page-aligned Bionic .so),
• this repo — patch delta, version pins, release pipeline: one command installs a single self-contained binary.

Docs

• Architecture & release pipeline
• Building on device / from source

Current pins

This channel's exact build inputs, regenerated automatically on every release. Other channels live on their own branch (beta / dev), all sourced from versions.json.

Component	Version
opencode (upstream)	1.19.1
@opentui/{core,keymap,solid} (JS, via @androidtui)	0.5.17
@androidtui/core-android-arm64 (native .so)	0.5.17
bun-termux runtime	1.4.3-patched (bd-loser/bun-termux)
bun-pty (Bionic pty .so, embedded)	0.4.8 (release asset)

FAQ

Root? 32-bit? Minimum Android?

No root, no proot, no chroot. Only aarch64 (arm64-v8a) is built, covering essentially every Android device from the last ~7 years. Minimum: Android 10 — the patched Bun runtime needs API 29.

Why not just npm install -g opencode in Termux?

Broken: opencode pulls in @opentui/core, whose glibc .so Bionic refuses. This build substitutes the Bionic-native @androidtui/* packages and compiles everything into one self-contained binary.

Which LLM providers work?

All of upstream's: Anthropic, OpenAI, and any OpenAI-compatible endpoint (OpenRouter, Groq, Ollama, …). Configuration is identical to upstream — see opencode.ai/docs.

How fast do updates land?

Automatically, within about an hour: upstream stable, beta, and dev activity each trigger a matching build here (one release per upstream version). See Channels.

Related repos

Repo	Role
bd-loser/bun-termux	Bun runtime patched for Bionic
bd-loser/opentui	opentui android-arm64 rebuild, publishes @androidtui/* (fork of anomalyco/opentui)

Upstream credit: anomalyco/opencode and anomalyco/opentui.

License

MIT — same as upstream opencode. See LICENSE.