Qwen Code Termux

Native Qwen Code CLI for Termux / Android ARM64. This fork tracks upstream QwenLM/qwen-code closely and carries only the Android/Termux compatibility delta needed to package and run it.

Install

Termux (Android ARM64)

pkg update && pkg upgrade -y
pkg install nodejs-lts -y
pkg install termux-api -y   # optional, only for TTS notifications
npm install -g \
  --allow-scripts=@mmmbuto/qwen-code-termux,@mmmbuto/node-pty-android-arm64,sharp \
  @mmmbuto/qwen-code-termux@latest
hash -r
qwen --version

npm 12 blocks install scripts by default. The narrow allowlist above permits only the fork's reviewed wrapper repair and its two native Termux dependency installers. If npm 12 previously installed the package without running those scripts, rerun the same command; do not replace the allowlist with a blanket script override.

Requirements:

• Android 7+ / API 24+
• ARM64 device
• Termux from F-Droid (Google Play build is outdated)
• Node.js >= 22

Other platforms

Use upstream:

npm install -g @qwen-code/qwen-code

Scope

What this fork does:

• tracks upstream Qwen Code release by release
• preserves only the Android/Termux compatibility delta upstream does not ship
• publishes a Termux-ready npm package and GitHub release assets
• maintains a small, verifiable patch surface (scripts/check-termux-patches.sh)

What this fork does not do:

• maintain a broad feature fork or product divergence
• replace upstream Qwen Code on non-Termux platforms
• carry fork-only features unrelated to Termux compatibility
• publish SDKs, VS Code extensions, channels, or Docker images downstream

Current Termux Delta

• Android ARM64 PTY fallback via @mmmbuto/node-pty-android-arm64 (prebuilt, bundled as optional dependency)
• Termux runtime detection (isTermux() checks process.platform, TERMUX_VERSION, PREFIX)
• base64 polyfills (btoa / atob) for older Android Node builds
• tts_notification tool backed by termux-tts-speak (requires termux-api)
• DEP0169 (url.parse deprecation) warning suppression in the CLI entry point
• install / update commands point users at @mmmbuto/qwen-code-termux
• managed background npm updates remain pinned to the fork package
• when npm lifecycle scripts are authorized, postinstall safely moves an exact orphaned upstream standalone wrapper out of PATH after the npm launcher is ready; the original is retained as qwen.qwen-code-termux-orphan
• prepare-termux skips husky and the bundle step inside Termux
• npm package metadata published under @mmmbuto/qwen-code-termux

Fork delta is verifiable end-to-end with:

bash scripts/check-termux-patches.sh

(21 markers across getPty.ts, termux-detect.ts, termux-runtime.ts, tts-notification.ts, cli/index.ts, installationInfo.ts, managed-npm-update.ts, scripts/, package.json)

If qwen still resolves to a shell-cached path after upgrading from the upstream standalone installer, run hash -r and verify the active launchers with type -a qwen.

Releases and Updates

• Latest GitHub release: releases/latest
• Upstream baseline: QwenLM/qwen-code v0.22.2, packaged as 0.22.2-termux
• npm package: @mmmbuto/qwen-code-termux
• This fork is end-of-life: 0.22.2-termux is the final release; no further upstream syncs or Termux updates are planned.

Maintainer publish flow:

• merge upstream release tag into develop
• verify the Termux delta with scripts/check-termux-patches.sh
• build, bundle, prepare:package, smoke qwen --version
• promote the tested commit to clean GitHub main and wait for Termux CI
• stage the exact audited npm tarball on next
• install that registry version on a real Termux device with the narrow script allowlist, then promote the same version to latest
• publish the GitHub release from main with the exact tarball and checksum
• add the verified on-device report to the release documentation

Authentication

Qwen Code Termux keeps upstream Qwen Code authentication behavior. Interactive:

/auth

API-key auth can be configured through ~/.qwen/settings.json or upstream provider environment variables. For Alibaba Cloud ModelStudio / DashScope:

export DASHSCOPE_API_KEY="YOUR_API_KEY"
qwen

The Qwen OAuth free tier was discontinued upstream on April 15, 2026. Use Alibaba Cloud Coding Plan, OpenRouter, Fireworks AI, or another configured API provider.

Validation

Termux on-device smoke suite: test-reports/suites/latest/termux.md

Minimum smoke:

qwen --version
qwen --help
qwen -p "Reply with OK"

Validation history under test-reports/.

Documentation

• Maintainer / scope of maintenance
• Notice
• Security policy
• Termux delta verifier: scripts/check-termux-patches.sh
• Latest Termux smoke suite: test-reports/suites/latest/termux.md
• Upstream docs index: docs/index.md

For generic Qwen Code documentation, refer to upstream.

License

Apache-2.0. This project remains under the Apache 2.0 license inherited from upstream Qwen Code.

• Original work: Alibaba Cloud (Qwen Team)
• Termux port: minimal Android compatibility patches

See LICENSE.

Per aspera ad astra.