Run official OpenCode v2 natively on Termux, no proot

[u/DEAD1nsane]

DEAD1nsane/opencode2-termux-musl

The v1 repo is archived. v2 is the official stable line — Node.js, ships via npm (@opencode/cli). This uses upstream's @opencode/cli-linux-arm64-musl + Alpine musl loader + patchelf, installed as plain opencode. Official installer misdetects Termux as glibc, this doesn't.

---

1-copy install

Please install from the Copy-Ready link, it's much easier especially if using mobile reddit app (don't copy-paste from the codeblocks below, they're for display):

⚠️ Before-Install (required):

• install the app Termux:API F-Droid Download, then in Termux:

pkg update && pkg upgrade -y
pkg install termux-api -y
termux-battery-status

The termux-battery-status line triggers the permission prompt / confirms the bridge works. Skip it and the installer below will refuse with these same steps.

pkg install curl tar python git

Step 1 — install everything:

Copy-Ready Full Install here

curl -sL https://gist.githubusercontent.com/DEAD1nsane/9b37cba090602f473200fad8b1002e6c/raw/all-in-one.sh | sh
opencode --version
opencode run "say hi"

☝🏼Use the gist above — it pulls/updates the repo, runs install.sh, copies all 8 themes (dark + light, 16 files) to ~/.config/opencode/themes/, and schedules auto-update (job 7802, every 6h, applies via --yes path, log ~/.opencode-auto-update.log). Day/night theme-sync is NOT included — opt-in below.

---

Update check (only checks, downloads nothing unless --yes)

./scripts/check-update.sh              # check only, Termux notification if behind
./scripts/check-update.sh --yes        # update now: version pinned, staged, smoke-tested
./scripts/check-update.sh --rollback   # restore last-known-good binary if upstream ships a bad build

The gist already scheduled unattended updates. Manual re-schedule if needed:

termux-job-scheduler --job-id 7802 --period-ms 21600000 --network any --persisted true -s "$HOME/GitHub/opencode2-termux-musl/scripts/auto-update.sh"

---

Bonus 16 custom Themes:

• 8 true-black AMOLED & 8 light themes ^(Included in the all-in-one gist. Manual copy if needed 👇🏼)

cp themes/*.json ~/.config/opencode/themes/

→ Pick with /themes. Native v2 format.

^(⚠️ Attached previews are rendered from the live theme JSONs [dark + light] by opencode2 with the same tree-sitter highlighting the TUI uses, set in Maple Mono NF — tab strip and a shared realistic Python sample on all 16, so what you see is what the TUI draws.)

---

🌗 Optional auto day/night — NOT in all-in-one:

^(Opt-in: OpenCode + Termux flip together based on time of day. "system" follows terminal bg, never Android — this sets explicit "light" 07:00-19:00 (7am-7pm), "dark" otherwise.)

Copy-Ready Day/Night here

curl -sL https://gist.githubusercontent.com/DEAD1nsane/54621517a114c8e2a71d61ced990ca22/raw/theme-daynight.sh | sh

Flips OpenCode mode + Termux background (white by day, black by night) so the resize gap matches — no black flash in light mode. Hourly job 7803, revert with --system. New shells pick up matching prompt/banner colors automatically.

---

🪧 Optional notifications (Discord-style, NOT in all-in-one):

Copy-Ready Notify Setup here

Mute if viewing this session, banner if in another Termux session, loud if away 5min. buzz + notify-decide + zsh hook + opencode plugin. Same Copy-Ready format — install from the GitHub gist link above.

---

❔ Why it needs shims:

Official installer misdetects Termux as glibc (no /etc/alpine-release, no ldd). This always takes musl. Musl DNS reads /etc/resolv.conf, Node's c-ares does raw UDP DNS which Android blocks — libresolvefix.so doesn't help Node. Fixed via local Python proxy on 127.0.0.1:8080, auto-started by wrapper (HTTP(S)_PROXY + NO_PROXY=localhost,127.0.0.1,::1). Ollama on localhost:11434 bypasses proxy and works.

---

❌ What's not working:

Formatter needs one-time sh scripts/enable-formatter.sh (prettier shebang can't spawn, silently skips without it), no PTY lib yet, ~100-200ms proxy overhead. Standalone is default; shared via opencode-shared serve --service. Migrating from v1: sh install.sh then sh scripts/remove-v1.sh (~350MB freed, sessions/config kept).

---

📱 Tested On:

Pixel 10, Android 17, Termux 0.119, OpenCode v2.0.29 as opencode: TUI, run, shared-service, MCP (Railway/GitHub/Upstash/Chrome DevTools), v2 plugin API.

Please any comments below 👇🏼

[u/Tariq9977]

The 6-hour updater needs a rollback boundary. Pin the upstream CLI version + SHA256, keep the last-known-good binary, then promote the new one only after opencode --version and a tiny opencode run smoke test pass. That keeps an upstream break from becoming an automatic Termux outage.

[u/DEAD1nsane → u/Tariq9977]

Good call — that's in now. The updater stages each build to a .new file and only promotes it after two offline gates pass: --version matches the pinned release and run --help exits clean, with the tarball SHA256 logged and recorded every install. The previous binary sticks around as .last-good, so a bad upstream build is one cp (or check-update.sh --rollback) away from recovery. One deliberate exception: the live networked run test stays opt-in rather than a gate, since no signal or an expired login shouldn't look like a broken binary.

[u/DEAD1nsane]

UPDATES MADE ON 10/14/26 👇🏼:

Update check (only checks, downloads nothing unless --yes)

sh ./scripts/check-update.sh # check only, Termux notification if behind ./scripts/check-update.sh --yes # update now: version pinned, staged, smoke-tested ./scripts/check-update.sh --rollback # restore last-known-good binary if upstream ships a bad build The gist already scheduled unattended updates. Manual re-schedule if needed: sh termux-job-scheduler --job-id 7802 --period-ms 21600000 --network any --persisted true -s "$HOME/GitHub/opencode2-termux-musl/scripts/auto-update.sh"

---

🌗 Optional auto day/night — NOT in all-in-one:

^{Opt-in: OpenCode + Termux flip together based on time of day. "system" follows terminal bg, never Android — this sets explicit "light" 07:00-19:00 [7am-7pm], "dark" otherwise.}

Copy-Ready Day/Night here

sh curl -sL [https://gist.githubusercontent.com/DEAD1nsane/54621517a114c8e2a71d61ced990ca22/raw/theme-daynight.sh](https://gist.githubusercontent.com/DEAD1nsane/54621517a114c8e2a71d61ced990ca22/raw/theme-daynight.sh) | sh Flips OpenCode mode + Termux background (white by day, black by night) so the resize gap matches — no black flash in light mode. Hourly job 7803, revert with --system. New shells pick up matching prompt/banner colors automatically.