feat: native Android (Termux) build + install.sh detection

- build btch-android-arm64 via bun-android-arm64 (bionic-linked, runs on Termux)
- shim @opentui/core-android-arm64 for bundling (libopentui.so is static)
- install.sh detects Termux and picks the android build, symlinks to $PREFIX/bin
- bump Bun in CI to 1.3.14 (Android compile target)

Author: BOTCAHX

.github/workflows/release.yml

@@ -44,6 +44,14 @@ jobs:
             build_output: btch-arm64
             asset_name: btch-linux-arm64
             compile_target: bun-linux-arm64
+          # Native Android (Termux) — Bun 1.3.14+ compiles a bionic-linked
+          # binary (interpreter /system/bin/linker64) that actually runs on
+          # Termux, unlike the glibc linux-arm64 build. libopentui.so is
+          # statically linked so the TUI works too.
+          - runner: ubuntu-latest
+            build_output: btch-android
+            asset_name: btch-android-arm64
+            compile_target: bun-android-arm64
           - runner: windows-latest
             build_output: btch.exe
             asset_name: btch-windows-x64.exe
@@ -74,20 +82,29 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.11
+          bun-version: 1.3.14
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
       # bun install only installs the OpenTUI platform package matching the
-      # *build host* (x64), so cross-compiling the arm64 binary needs the
-      # linux-arm64 native package present too (Bun bundles it at build time).
+      # *build host* (x64), so cross-compiling the arm64/android binaries needs
+      # the arm64 native package present too (Bun bundles it at build time).
       # The shared script downloads the tarball directly, bypassing npm's
       # os/cpu check without touching package.json/lockfiles.
       - name: Install ARM64 OpenTUI native package (cross-compile)
-        if: matrix.asset_name == 'btch-linux-arm64'
+        if: contains(matrix.asset_name, 'arm64')
         run: node scripts/install-opentui-platform.mjs @opentui/core-linux-arm64
 
+      # OpenTUI has no android package; for the android target Bun resolves
+      # @opentui/core-android-arm64 at build time. libopentui.so is statically
+      # linked, so the linux-arm64 package works verbatim as the android shim.
+      - name: Shim Android OpenTUI package
+        if: matrix.asset_name == 'btch-android-arm64'
+        run: |
+          mkdir -p node_modules/@opentui/core-android-arm64
+          cp -r node_modules/@opentui/core-linux-arm64/. node_modules/@opentui/core-android-arm64/
+
       - name: Compile standalone binary
         run: bun build --compile --target="${{ matrix.compile_target }}" --outfile "release/${{ matrix.build_output }}" ./src/index.ts
 
@@ -161,6 +178,7 @@ jobs:
             release-assets/**/btch-linux-x64
             release-assets/**/btch-linux-x64-baseline
             release-assets/**/btch-linux-arm64
+            release-assets/**/btch-android-arm64
             release-assets/**/btch-darwin-arm64
             release-assets/**/btch-windows-x64.exe
             release-assets/checksums.txt
@@ -194,7 +212,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.11
+          bun-version: 1.3.14
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.5] - 2026-08-17
+
+### Added
+- **Native Android (Termux) build**: release now ships `btch-android-arm64` (bionic-linked, Bun 1.3.14+ `bun-android-arm64` target) that runs directly on Termux with the full interactive TUI
+- `install.sh` detects Termux automatically and downloads the Android build (plus symlinks to `$PREFIX/bin`)
+
+### Fixed
+- `install.sh` on Termux previously downloaded the glibc `linux-arm64` binary, which cannot execute on Termux (bionic libc) — `cannot execute: required file not found`
+
 ## [3.0.4] - 2026-08-17
 
 ### Added

README.md

@@ -58,15 +58,17 @@ yarn global add btch-cli
 
 **Android / Termux:**
 
-- **npm route** (recommended) — `npm install -g btch-cli` works on Termux.
-  The installer auto-detects Termux and installs OpenTUI's native ARM64
-  component, which npm normally skips on Android. Requires Bun for Android
-  (Bun ≥ 1.3.14 supports Android natively; install it with
-  `curl -fsSL https://bun.sh/install | bash` or via Termux packages).
-- **Headless mode** — `btch --prompt "..."` does not need the interactive UI
-  and is the most reliable way to run the agent inside Termux.
-- The standalone `install.sh` binary also ships an ARM64 build
-  (`btch-linux-arm64`, cross-compiled), so Raspberry Pi / ARM Linux works too.
+- **One-liner works** — `curl -fsSL https://raw.githubusercontent.com/hostinger-bot/btch-cli/main/install.sh | bash`
+  detects Termux and downloads the **native Android build** (`btch-android-arm64`,
+  bionic-linked), which runs directly on Termux with the full interactive TUI.
+- **npm route** — `npm install -g btch-cli` also works on Termux (requires Bun
+  for Android; Bun ≥ 1.3.14 supports Android natively). The postinstall hook
+  auto-installs OpenTUI's native ARM64 component, which npm normally skips on
+  Android.
+- **Headless mode** — `btch --prompt "..."` runs without the interactive UI
+  and is the most lightweight way to use the agent inside Termux.
+- The release also ships `btch-linux-arm64` (glibc) for Raspberry Pi / ARM
+  Linux servers — that one does **not** run on Termux (Termux uses bionic libc).
 
 **Prerequisites:** an **API key** for your OpenAI-compatible endpoint and a modern terminal emulator for the interactive OpenTUI experience. Headless `--prompt` mode does not depend on terminal UI support. If you want host desktop automation via the built-in computer sub-agent, also enable **Accessibility** permission for your terminal app on macOS.
 

install.sh

@@ -68,18 +68,32 @@ done
 mkdir -p "$INSTALL_DIR"
 chmod 700 "$USER_DIR" "$INSTALL_DIR"
 
+is_termux() {
+  # Android/Termux uses the bionic libc, so the glibc linux-arm64 binary
+  # cannot run there ("cannot execute: required file not found"). Detect it
+  # and pick the dedicated android-arm64 build instead.
+  [[ -n "${TERMUX_VERSION:-}" ]] && return 0
+  [[ -d /data/data/com.termux ]] && return 0
+  [[ "$(uname -o 2>/dev/null)" == "Android" ]] && return 0
+  return 1
+}
+
 resolve_target() {
   local raw_os arch
   raw_os=$(uname -s)
-  case "$raw_os" in
-    Darwin*) OS="darwin" ;;
-    Linux*)  OS="linux" ;;
-    MINGW*|MSYS*|CYGWIN*) OS="windows" ;;
-    *)
-      echo "Unsupported OS: ${raw_os}" >&2
-      exit 1
-      ;;
-  esac
+  if is_termux; then
+    OS="android"
+  else
+    case "$raw_os" in
+      Darwin*) OS="darwin" ;;
+      Linux*)  OS="linux" ;;
+      MINGW*|MSYS*|CYGWIN*) OS="windows" ;;
+      *)
+        echo "Unsupported OS: ${raw_os}" >&2
+        exit 1
+        ;;
+    esac
+  fi
 
   arch=$(uname -m)
   case "$arch" in
@@ -92,7 +106,7 @@ resolve_target() {
   esac
 
   case "${OS}-${ARCH}" in
-    darwin-arm64|linux-x64|linux-arm64|windows-x64) ;;
+    darwin-arm64|linux-x64|linux-arm64|android-arm64|windows-x64) ;;
     *)
       echo "Unsupported platform: ${OS}-${ARCH}" >&2
       exit 1
@@ -165,18 +179,27 @@ METAEOF
 
 setup_global_symlink() {
   # Create a symlink in a system bin dir that is already on PATH (e.g.
-  # /usr/local/bin) so `btch` works immediately in the current session
-  # without needing to source shell config. Only done when possible; the
-  # script falls back to the PATH hint otherwise.
+  # /usr/local/bin, or $PREFIX/bin on Termux) so `btch` works immediately in
+  # the current session without needing to source shell config. Only done
+  # when possible; the script falls back to the PATH hint otherwise.
   GLOBAL_BIN_PATH=""
   [[ "$TARGET" == windows-* ]] && return 0
-  [[ -w /usr/local/bin ]] || return 0
-  if [[ -e "/usr/local/bin/${BINARY_NAME}" ]] && [[ ! -L "/usr/local/bin/${BINARY_NAME}" ]]; then
+
+  local bin_dir=""
+  if is_termux && [[ -n "${PREFIX:-}" ]] && [[ -w "${PREFIX}/bin" ]]; then
+    # Termux keeps $PREFIX/bin (e.g. /data/data/com.termux/files/usr/bin) on PATH.
+    bin_dir="${PREFIX}/bin"
+  elif [[ -w /usr/local/bin ]]; then
+    bin_dir="/usr/local/bin"
+  fi
+  [[ -n "$bin_dir" ]] || return 0
+
+  if [[ -e "${bin_dir}/${BINARY_NAME}" ]] && [[ ! -L "${bin_dir}/${BINARY_NAME}" ]]; then
     # A real file (not our symlink) already exists; don't clobber it.
     return 0
   fi
-  if ln -sf "${INSTALL_DIR}/${BINARY_NAME}" "/usr/local/bin/${BINARY_NAME}" 2>/dev/null; then
-    GLOBAL_BIN_PATH="/usr/local/bin/${BINARY_NAME}"
+  if ln -sf "${INSTALL_DIR}/${BINARY_NAME}" "${bin_dir}/${BINARY_NAME}" 2>/dev/null; then
+    GLOBAL_BIN_PATH="${bin_dir}/${BINARY_NAME}"
   fi
 }
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "btch-cli",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "An open-source AI coding agent, built with Bun and OpenTUI.",
   "type": "module",
   "main": "dist/index.js",