@mmmbuto/qwen-code-termux 0.16.1-termux → 0.18.0-termux

package/README.md

@@ -1,125 +1,110 @@
 # Qwen Code Termux
 
-[![npm version](https://img.shields.io/npm/v/@mmmbuto/qwen-code-termux.svg)](https://www.npmjs.com/package/@mmmbuto/qwen-code-termux)
-[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
+> Native Qwen Code CLI for **Termux / Android ARM64**.
+> This fork tracks upstream [QwenLM/qwen-code](https://github.com/QwenLM/qwen-code) closely and carries only the Android/Termux compatibility delta needed to package and run it.
 
-Termux-first build of [Qwen Code](https://github.com/QwenLM/qwen-code) for
-Android ARM64.
-
-This fork tracks upstream release-by-release and keeps the fork delta limited to
-Android/Termux compatibility, packaging, and validation assets.
-
-Current fork release: `0.16.1-termux`.
-
-## Release Channel
-
-`main` follows upstream stable releases. Upstream preview and nightly builds are
-tracked only for analysis unless a Termux-specific validation pass decides to
-publish a separate prerelease.
-
-Current upstream baseline: `QwenLM/qwen-code` `v0.16.1`.
+[![npm termux](https://img.shields.io/npm/v/@mmmbuto/qwen-code-termux?style=flat-square&logo=npm)](https://www.npmjs.com/package/@mmmbuto/qwen-code-termux)
+[![latest release](https://img.shields.io/github/v/release/DioNanos/qwen-code-termux?style=flat-square)](https://github.com/DioNanos/qwen-code-termux/releases/latest)
+[![license](https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square)](./LICENSE)
 
 ## Install
 
-```bash
-pkg install nodejs-lts
-pkg install termux-api   # optional, only for TTS notifications
+### Termux (Android ARM64)
 
+```bash
+pkg update && pkg upgrade -y
+pkg install nodejs-lts -y
+pkg install termux-api -y   # optional, only for TTS notifications
 npm install -g @mmmbuto/qwen-code-termux@latest
 qwen --version
 ```
 
 Requirements:
 
-- Termux from F-Droid
-- Node.js 20+
-- `termux-api` only if you want `termux-tts-speak` integration
+- Android 7+ / API 24+
+- ARM64 device
+- Termux from F-Droid (Google Play build is outdated)
+- Node.js >= 20
+
+### Other platforms
 
-For non-Termux platforms, use upstream:
+Use upstream:
 
 ```bash
 npm install -g @qwen-code/qwen-code
 ```
 
-## Usage
-
-```bash
-cd your-project
-qwen
-```
+## Scope
 
-Headless:
+What this fork does:
 
-```bash
-qwen -p "Explain this project" -o json
-```
+- 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`)
 
-Useful slash commands:
+What this fork does not do:
 
-- `/help`
-- `/auth`
-- `/model`
+- 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
 
-## Authentication
+## Current Termux Delta
 
-Qwen Code Termux keeps upstream Qwen Code authentication behavior.
+- 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`
+- `postinstall` + `prepare-termux` scripts skip husky and the bundle step inside Termux
+- npm package metadata published under `@mmmbuto/qwen-code-termux`
 
-Interactive auth:
+Fork delta is verifiable end-to-end with:
 
-```text
-/auth
+```bash
+bash scripts/check-termux-patches.sh
 ```
 
-API-key auth can be configured through `~/.qwen/settings.json` or environment
-variables supported by upstream providers.
+(16 markers across `getPty.ts`, `termux-detect.ts`, `termux-runtime.ts`, `tts-notification.ts`, `cli/index.ts`, `installationInfo.ts`, `scripts/`, `package.json`)
 
-For Alibaba Cloud ModelStudio / DashScope:
+## Releases and Updates
 
-```bash
-export DASHSCOPE_API_KEY="YOUR_API_KEY"
-qwen
-```
+- Latest GitHub release: [releases/latest](https://github.com/DioNanos/qwen-code-termux/releases/latest)
+- Upstream baseline: [`QwenLM/qwen-code` v0.18.0](https://github.com/QwenLM/qwen-code/releases/tag/v0.18.0), packaged as `0.18.0-termux` (npm `next`; promoted to `latest` after validation)
+- npm package: [`@mmmbuto/qwen-code-termux`](https://www.npmjs.com/package/@mmmbuto/qwen-code-termux)
 
-Qwen OAuth free tier was discontinued upstream on April 15, 2026. Use Alibaba
-Cloud Coding Plan, OpenRouter, Fireworks AI, or another configured API provider.
+Maintainer publish flow:
 
-## Termux Delta
+- merge upstream release tag into `develop`
+- verify the Termux delta with `scripts/check-termux-patches.sh`
+- build, bundle, prepare:package, smoke `qwen --version`
+- publish the tested npm tarball to `latest`
+- promote the tested commit to clean GitHub `main`
+- publish the GitHub release from `main` with the tarball asset
+- add post-release Termux validation reports after on-device testing
 
-This fork adds or preserves:
-
-- Android ARM64 PTY fallback through `@mmmbuto/node-pty-android-arm64`
-- optional `tts_notification` support backed by `termux-tts-speak`
-- Termux environment detection for runtime-specific behavior
-- Android/Termux runtime patch bootstrap
-- npm publish package metadata under `@mmmbuto/qwen-code-termux`
-- release validation docs under `test-reports/`
+## Authentication
 
-After upstream merges or release prep, verify the fork delta with:
+Qwen Code Termux keeps upstream Qwen Code authentication behavior. Interactive:
 
-```bash
-bash scripts/check-termux-patches.sh
+```text
+/auth
 ```
 
-## Build
+API-key auth can be configured through `~/.qwen/settings.json` or upstream provider environment variables. For Alibaba Cloud ModelStudio / DashScope:
 
 ```bash
-git clone https://github.com/DioNanos/qwen-code-termux.git
-cd qwen-code-termux
-npm install
-npm run build
-npm run bundle
-npm run prepare:package
-node dist/cli.js --version
+export DASHSCOPE_API_KEY="YOUR_API_KEY"
+qwen
 ```
 
-The publishable npm artifact is prepared under `dist/`.
-
-## Release Validation
+> 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.
 
-The public validation history lives in:
+## Validation
 
-- [test-reports/README.md](test-reports/README.md)
-- [test-reports/suites/latest/termux.md](test-reports/suites/latest/termux.md)
+Termux on-device smoke suite: [test-reports/suites/latest/termux.md](./test-reports/suites/latest/termux.md)
 
 Minimum smoke:
 
@@ -129,43 +114,28 @@ qwen --help
 qwen -p "Reply with OK"
 ```
 
-## Maintenance Scope
-
-In scope for this fork:
-
-- Android/Termux runtime compatibility
-- npm package `@mmmbuto/qwen-code-termux`
-- Termux validation reports and release assets
-- minimal fork-owned GitHub CI/release automation
-
-Out of scope:
+Validation history under [test-reports/](./test-reports/).
 
-- generic Qwen Code feature requests
-- upstream product behavior unrelated to Termux
-- upstream Alibaba/Qwen infrastructure, bots, or release workflows
-- SDK, VS Code extension, channel, or Docker image publishing from this fork
+## Documentation
 
-Generic issues should be filed upstream at
-[QwenLM/qwen-code](https://github.com/QwenLM/qwen-code). Termux-specific issues
-should be filed here.
+- [Maintainer / scope of maintenance](./MAINTAINER.md)
+- [Notice](./NOTICE)
+- [Security policy](./SECURITY.md)
+- Termux delta verifier: [scripts/check-termux-patches.sh](./scripts/check-termux-patches.sh)
+- Latest Termux smoke suite: [test-reports/suites/latest/termux.md](./test-reports/suites/latest/termux.md)
+- Upstream docs index: [docs/index.md](./docs/index.md)
 
-## Security
+For generic Qwen Code documentation, refer to [upstream](https://github.com/QwenLM/qwen-code).
 
-See [SECURITY.md](SECURITY.md).
-
-Termux-fork-specific security reports: `security@mmmbuto.com`.
-
-Upstream-relevant security reports should follow the upstream Alibaba/Qwen
-security process described in `SECURITY.md`.
+## License
 
-## Maintainer
+Apache-2.0. This project remains under the Apache 2.0 license inherited from upstream Qwen Code.
 
-Maintained by [DioNanos](https://github.com/DioNanos) as the Termux/Android
-porting and distribution fork.
+- Original work: Alibaba Cloud (Qwen Team)
+- Termux port: minimal Android compatibility patches
 
-See [MAINTAINER.md](MAINTAINER.md) and [NOTICE](NOTICE).
+See [LICENSE](./LICENSE).
 
-## License
+---
 
-Apache-2.0. This fork is distributed under the same license as upstream Qwen
-Code. The Android/Termux compatibility patches are distributed under Apache-2.0.
+*Per aspera ad astra.*

package/bundled/new-app/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: new-app
+description: Workflow for creating new applications from scratch. Covers requirements gathering, tech stack selection, scaffolding, implementation, and delivery of a functional prototype.
+when_to_use: When the user asks to create a new application, project, website, game, mobile app, CLI tool, or library from scratch.
+---
+
+**Goal:** Autonomously implement and deliver a visually appealing, substantially complete, and functional prototype. Utilize all tools at your disposal to implement the application. Some tools you may especially find useful are 'write_file', 'edit' and 'run_shell_command'.
+
+1. **Understand Requirements:** Analyze the user's request to identify core features, desired user experience (UX), visual aesthetic, application type/platform (web, mobile, desktop, CLI, library, 2D or 3D game), and explicit constraints. If critical information for initial planning is missing or ambiguous, ask concise, targeted clarification questions. Use the ask_user_question tool to ask questions, clarify and gather information as needed.
+2. **Propose Plan:** Formulate an internal development plan. Present a clear, concise, high-level summary to the user. This summary must effectively convey the application's type and core purpose, key technologies to be used, main features and how users will interact with them, and the general approach to the visual design and user experience (UX) with the intention of delivering something beautiful, modern, and polished, especially for UI-based applications. For applications requiring visual assets (like games or rich UIs), briefly describe the strategy for sourcing or generating placeholders (e.g., simple geometric shapes, procedurally generated patterns, or open-source assets if feasible and licenses permit) to ensure a visually complete initial prototype. Ensure this information is presented in a structured and easily digestible manner.
+   - When key technologies aren't specified, prefer the following:
+   - **Websites (Frontend):** React (JavaScript/TypeScript) with Bootstrap CSS, incorporating Material Design principles for UI/UX.
+   - **Back-End APIs:** Node.js with Express.js (JavaScript/TypeScript) or Python with FastAPI.
+   - **Full-stack:** Next.js (React/Node.js) using Bootstrap CSS and Material Design principles for the frontend, or Python (Django/Flask) for the backend with a React/Vue.js frontend styled with Bootstrap CSS and Material Design principles.
+   - **CLIs:** Python or Go.
+   - **Mobile App:** Compose Multiplatform (Kotlin Multiplatform) or Flutter (Dart) using Material Design libraries and principles, when sharing code between Android and iOS. Jetpack Compose (Kotlin JVM) with Material Design principles or SwiftUI (Swift) for native apps targeted at either Android or iOS, respectively.
+   - **3D Games:** HTML/CSS/JavaScript with Three.js.
+   - **2D Games:** HTML/CSS/JavaScript.
+3. **User Approval:** Obtain user approval for the proposed plan.
+4. **Implementation:** Use the 'todo_write' tool to convert the approved plan into a structured todo list with specific, actionable tasks, then autonomously implement each task utilizing all available tools. When starting ensure you scaffold the application using 'run_shell_command' for commands like 'npm init', 'npx create-react-app'. Aim for full scope completion. Proactively create or source necessary placeholder assets (e.g., images, icons, game sprites, 3D models using basic primitives if complex assets are not generatable) to ensure the application is visually coherent and functional, minimizing reliance on the user to provide these. If the model can generate simple assets (e.g., a uniformly colored square sprite, a simple 3D cube), it should do so. Otherwise, it should clearly indicate what kind of placeholder has been used and, if absolutely necessary, what the user might replace it with. Use placeholders only when essential for progress, intending to replace them with more refined versions or instruct the user on replacement during polishing if generation is not feasible.
+5. **Verify:** Review work against the original request, the approved plan. Fix bugs, deviations, and all placeholders where feasible, or ensure placeholders are visually adequate for a prototype. Ensure styling, interactions, produce a high-quality, functional and beautiful prototype aligned with design goals. Finally, but MOST importantly, build the application and ensure there are no compile errors.
+6. **Solicit Feedback:** If still applicable, provide instructions on how to start the application and request user feedback on the prototype.

package/bundled/qc-helper/SKILL.md

@@ -43,25 +43,29 @@ Use this index to locate the right document for the user's question. Load only t
 | Model providers (OpenAI-compatible, etc.) | `docs/configuration/model-providers.md` |
 | .qwenignore file                          | `docs/configuration/qwen-ignore.md`     |
 | Themes                                    | `docs/configuration/themes.md`          |
-| Memory                                    | `docs/configuration/memory.md`          |
 | Trusted folders                           | `docs/configuration/trusted-folders.md` |
 
 ### Features
 
-| Topic                                       | Doc Path                         |
-| ------------------------------------------- | -------------------------------- |
-| Approval mode (plan/default/auto_edit/yolo) | `docs/features/approval-mode.md` |
-| MCP (Model Context Protocol)                | `docs/features/mcp.md`           |
-| Skills system                               | `docs/features/skills.md`        |
-| Sub-agents                                  | `docs/features/sub-agents.md`    |
-| Sandbox / security                          | `docs/features/sandbox.md`       |
-| Slash commands                              | `docs/features/commands.md`      |
-| Headless / non-interactive mode             | `docs/features/headless.md`      |
-| LSP integration                             | `docs/features/lsp.md`           |
-| Checkpointing                               | `docs/features/checkpointing.md` |
-| Token caching                               | `docs/features/token-caching.md` |
-| Language / i18n                             | `docs/features/language.md`      |
-| Arena mode                                  | `docs/features/arena.md`         |
+| Topic                                       | Doc Path                           |
+| ------------------------------------------- | ---------------------------------- |
+| Approval mode (plan/default/auto_edit/yolo) | `docs/features/approval-mode.md`   |
+| Auto mode (AI-driven approval)              | `docs/features/auto-mode.md`       |
+| Hooks (lifecycle hooks)                     | `docs/features/hooks.md`           |
+| MCP (Model Context Protocol)                | `docs/features/mcp.md`             |
+| Memory                                      | `docs/features/memory.md`          |
+| Skills system                               | `docs/features/skills.md`          |
+| Sub-agents                                  | `docs/features/sub-agents.md`      |
+| Sandbox / security                          | `docs/features/sandbox.md`         |
+| Slash commands                              | `docs/features/commands.md`        |
+| Headless / non-interactive mode             | `docs/features/headless.md`        |
+| LSP integration                             | `docs/features/lsp.md`             |
+| Token caching                               | `docs/features/token-caching.md`   |
+| Language / i18n                             | `docs/features/language.md`        |
+| Arena mode                                  | `docs/features/arena.md`           |
+| Status line                                 | `docs/features/status-line.md`     |
+| Scheduled tasks (cron/loop)                 | `docs/features/scheduled-tasks.md` |
+| Worktree                                    | `docs/features/worktree.md`        |
 
 ### IDE Integration
 
@@ -111,15 +115,16 @@ When the user asks about configuration, the primary reference is `docs/configura
 
 ### Common Config Categories
 
-| Category      | Key Config Keys                                                               | Reference                                                                 |
-| ------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
-| Permissions   | `permissions.allow/ask/deny`                                                  | `docs/configuration/settings.md`, `docs/features/approval-mode.md`        |
-| MCP Servers   | `mcpServers.*`, `mcp.*`                                                       | `docs/configuration/settings.md`, `docs/features/mcp.md`                  |
-| Tool Approval | `tools.approvalMode`                                                          | `docs/configuration/settings.md`, `docs/features/approval-mode.md`        |
-| Model         | `model.name`, `modelProviders`                                                | `docs/configuration/settings.md`, `docs/configuration/model-providers.md` |
-| General/UI    | `general.*`, `ui.*`, `ide.*`, `output.*`                                      | `docs/configuration/settings.md`                                          |
-| Context       | `context.*`                                                                   | `docs/configuration/settings.md`                                          |
-| Advanced      | `hooks`, `env`, `webSearch`, `security`, `privacy`, `telemetry`, `advanced.*` | `docs/configuration/settings.md`                                          |
+| Category      | Key Config Keys                                                      | Reference                                                                                        |
+| ------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| Permissions   | `permissions.allow/ask/deny`                                         | `docs/configuration/settings.md`, `docs/features/approval-mode.md`                               |
+| MCP Servers   | `mcpServers.*`, `mcp.*`                                              | `docs/configuration/settings.md`, `docs/features/mcp.md`                                         |
+| Tool Approval | `tools.approvalMode`                                                 | `docs/configuration/settings.md`, `docs/features/approval-mode.md`, `docs/features/auto-mode.md` |
+| Hooks         | `hooks.*`                                                            | `docs/configuration/settings.md`, `docs/features/hooks.md`                                       |
+| Model         | `model.name`, `modelProviders`                                       | `docs/configuration/settings.md`, `docs/configuration/model-providers.md`                        |
+| General/UI    | `general.*`, `ui.*`, `ide.*`, `output.*`                             | `docs/configuration/settings.md`                                                                 |
+| Context       | `context.*`                                                          | `docs/configuration/settings.md`                                                                 |
+| Advanced      | `env`, `webSearch`, `security`, `privacy`, `telemetry`, `advanced.*` | `docs/configuration/settings.md`                                                                 |
 
 ---
 

package/bundled/qc-helper/docs/_meta.ts

@@ -15,6 +15,7 @@ export default {
   'integration-jetbrains': 'JetBrains IDEs',
   'integration-github-action': 'GitHub Actions',
   'qwen-serve': 'Daemon mode (qwen serve)',
+  'qwen-serve-deploy-local': 'Daemon mode — local launch templates',
   'Code with Qwen Code': {
     type: 'separator',
     title: 'Code with Qwen Code', // Title is optional

package/bundled/qc-helper/docs/configuration/_meta.ts

@@ -1,9 +1,6 @@
 export default {
   settings: 'Settings',
   auth: 'Authentication',
-  memory: {
-    display: 'hidden',
-  },
   'qwen-ignore': 'Ignoring Files',
   'trusted-folders': 'Trusted Folders',
   themes: 'Themes',