@mmmbuto/qwen-code-termux 0.14.1-termux → 0.15.5-termux

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

@@ -1,10 +1,14 @@
 export default {
   commands: 'Commands',
+  'code-review': 'Code Review',
   'followup-suggestions': 'Followup Suggestions',
+  'tool-use-summaries': 'Tool-Use Summaries',
   'sub-agents': 'SubAgents',
   arena: 'Agent Arena',
   skills: 'Skills',
+  memory: 'Memory',
   headless: 'Headless Mode',
+  'dual-output': 'Dual Output',
   checkpointing: {
     display: 'hidden',
   },
@@ -16,5 +20,7 @@ export default {
   language: 'i18n',
   channels: 'Channels',
   hooks: 'Hooks',
+  'status-line': 'Status Line',
   'scheduled-tasks': 'Scheduled Tasks',
+  tips: 'Contextual Tips',
 };

package/bundled/qc-helper/docs/features/approval-mode.md

@@ -1,6 +1,6 @@
 # Approval Mode
 
-Qwen Code offers three distinct permission modes that allow you to flexibly control how AI interacts with your code and system based on task complexity and risk level.
+Qwen Code offers four distinct permission modes that allow you to flexibly control how AI interacts with your code and system based on task complexity and risk level.
 
 ## Permission Modes Comparison
 
@@ -40,6 +40,18 @@ You can switch into Plan Mode during a session using **Shift+Tab** (or **Tab** o
 
 If you are in Normal Mode, **Shift+Tab** (or **Tab** on Windows) first switches into `auto-edits` Mode, indicated by `⏵⏵ accept edits on` at the bottom of the terminal. A subsequent **Shift+Tab** (or **Tab** on Windows) will switch into Plan Mode, indicated by `⏸ plan mode`.
 
+**Use the `/plan` command**
+
+The `/plan` command provides a quick shortcut for entering and exiting Plan Mode:
+
+```bash
+/plan                          # Enter plan mode
+/plan refactor the auth module # Enter plan mode and start planning
+/plan exit                     # Exit plan mode, restore previous mode
+```
+
+When you exit Plan Mode with `/plan exit`, your previous approval mode is automatically restored (e.g., if you were in Auto-Edit before entering Plan Mode, you'll return to Auto-Edit).
+
 **Start a new session in Plan Mode**
 
 To start a new session in Plan Mode, use the `/approval-mode` then select `plan`
@@ -59,14 +71,10 @@ qwen --prompt "What is machine learning?"
 ### Example: Planning a complex refactor
 
 ```bash
-/approval-mode plan
-```
-
-```
-I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
+/plan I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
 ```
 
-Qwen Code analyzes the current implementation and create a comprehensive plan. Refine with follow-ups:
+Qwen Code enters Plan Mode and analyzes the current implementation to create a comprehensive plan. Refine with follow-ups:
 
 ```
 What about backward compatibility?
@@ -235,7 +243,7 @@ qwen --prompt "Run the test suite, fix all failing tests, then commit changes"
 
 ### Keyboard Shortcut Switching
 
-During a Qwen Code session, use **Shift+Tab**​ (or **Tab** on Windows) to quickly cycle through the three modes:
+During a Qwen Code session, use **Shift+Tab**​ (or **Tab** on Windows) to quickly cycle through the four modes:
 
 ```
 Default Mode → Auto-Edit Mode → YOLO Mode → Plan Mode → Default Mode

package/bundled/qc-helper/docs/features/arena.md

@@ -90,8 +90,9 @@ When all agents complete, the Arena enters the result comparison phase. You'll s
 
 - **Status summary**: Which agents succeeded, failed, or were cancelled
 - **Execution metrics**: Duration, rounds of reasoning, token usage, and tool call counts for each agent
+- **Arena comparison summary**: Files changed in common vs. by one agent only, line-change counts, token efficiency, and a high-level approach summary generated from each agent's diff, metrics, and conversation history
 
-A selection dialog presents the successful agents. Choose one to apply its changes to your main workspace, or discard all results.
+A selection dialog presents the successful agents. Choose one to apply its changes to your main workspace, or discard all results. Press `p` to toggle a quick preview for the highlighted agent, or `d` to toggle that agent's detailed diff before selecting a winner.
 
 ### What happens when you select a winner
 
@@ -99,7 +100,7 @@ A selection dialog presents the successful agents. Choose one to apply its chang
 2. The diff is applied to your main working directory
 3. All worktrees and temporary branches are cleaned up automatically
 
-If you want to inspect results before deciding, each agent's full conversation history is available via the tab bar while the selection dialog is active.
+If you want to inspect the complete reasoning path before deciding, each agent's full conversation history is still available via the tab bar while the selection dialog is active.
 
 ## Configuration
 

package/bundled/qc-helper/docs/features/code-review.md

@@ -0,0 +1,279 @@
+# Code Review
+
+> Review code changes for correctness, security, performance, and code quality using `/review`.
+
+## Quick Start
+
+```bash
+# Review local uncommitted changes
+/review
+
+# Review a pull request (by number or URL)
+/review 123
+/review https://github.com/org/repo/pull/123
+
+# Review and post inline comments on the PR
+/review 123 --comment
+
+# Review a specific file
+/review src/utils/auth.ts
+```
+
+If there are no uncommitted changes, `/review` will let you know and stop — no agents are launched.
+
+## How It Works
+
+The `/review` command runs a multi-stage pipeline:
+
+```
+Step 1:  Determine scope (local diff / PR worktree / file)
+Step 2:  Load project review rules
+Step 3:  Run deterministic analysis (linter, typecheck)    [zero LLM cost]
+Step 4:  5 parallel review agents                          [5 LLM calls]
+           |-- Agent 1: Correctness & Security
+           |-- Agent 2: Code Quality
+           |-- Agent 3: Performance & Efficiency
+           |-- Agent 4: Undirected Audit
+           '-- Agent 5: Build & Test (runs shell commands)
+Step 5:  Deduplicate --> Batch verify --> Aggregate         [1 LLM call]
+Step 6:  Reverse audit (find coverage gaps)                 [1 LLM call]
+Step 7:  Present findings + verdict
+Step 8:  Autofix (user-confirmed, optional)
+Step 9:  Post PR inline comments (if requested)
+Step 10: Save report + incremental cache
+Step 11: Clean up (remove worktree + temp files)
+```
+
+### Review Agents
+
+| Agent                             | Focus                                                              |
+| --------------------------------- | ------------------------------------------------------------------ |
+| Agent 1: Correctness & Security   | Logic errors, null handling, race conditions, injection, XSS, SSRF |
+| Agent 2: Code Quality             | Style consistency, naming, duplication, dead code                  |
+| Agent 3: Performance & Efficiency | N+1 queries, memory leaks, unnecessary re-renders, bundle size     |
+| Agent 4: Undirected Audit         | Business logic, boundary interactions, hidden coupling             |
+| Agent 5: Build & Test             | Runs build and test commands, reports failures                     |
+
+All agents run in parallel. Findings from Agents 1-4 are verified in a **single batch verification pass** (one agent reviews all findings at once, keeping LLM calls fixed). After verification, a **reverse audit agent** re-reads the entire diff with knowledge of all confirmed findings to catch issues that every other agent missed. Reverse audit findings skip the verification step (the agent already has full context) and are included directly as high-confidence results.
+
+## Deterministic Analysis
+
+Before the LLM agents run, `/review` automatically runs your project's existing linters and type checkers:
+
+| Language              | Tools detected                                                   |
+| --------------------- | ---------------------------------------------------------------- |
+| TypeScript/JavaScript | `tsc --noEmit`, `npm run lint`, `eslint`                         |
+| Python                | `ruff`, `mypy`, `flake8`                                         |
+| Rust                  | `cargo clippy`                                                   |
+| Go                    | `go vet`, `golangci-lint`                                        |
+| Java                  | `mvn compile`, `checkstyle`, `spotbugs`, `pmd`                   |
+| C/C++                 | `clang-tidy` (if `compile_commands.json` available)              |
+| Other                 | Auto-discovered from CI config (`.github/workflows/*.yml`, etc.) |
+
+For projects that don't match standard patterns (e.g., OpenJDK), `/review` reads CI configuration files to discover what lint/check commands the project uses. No user configuration needed.
+
+Deterministic findings are tagged with `[linter]` or `[typecheck]` and skip LLM verification — they are ground truth.
+
+- **Errors** → Critical severity
+- **Warnings** → Nice to have (terminal only, not posted as PR comments)
+
+If a tool is not installed or times out, it is skipped with an informational note.
+
+## Severity Levels
+
+| Severity         | Meaning                                                             | Posted as PR comment?      |
+| ---------------- | ------------------------------------------------------------------- | -------------------------- |
+| **Critical**     | Must fix before merging (bugs, security, data loss, build failures) | Yes (high-confidence only) |
+| **Suggestion**   | Recommended improvement                                             | Yes (high-confidence only) |
+| **Nice to have** | Optional optimization                                               | No (terminal only)         |
+
+Low-confidence findings appear in a separate "Needs Human Review" section in the terminal and are never posted as PR comments.
+
+## Autofix
+
+After presenting findings, `/review` offers to auto-apply fixes for Critical and Suggestion findings that have clear solutions:
+
+```
+Found 3 issues with auto-fixable suggestions. Apply auto-fixes? (y/n)
+```
+
+- Fixes are applied using the `edit` tool (targeted replacements, not full-file rewrites)
+- Per-file linter checks run after fixes to verify they don't introduce new issues
+- For PR reviews, fixes are committed and pushed from the worktree automatically — your working tree stays clean
+- Nice to have and low-confidence findings are never auto-fixed
+- PR review submission always uses the **pre-fix verdict** (e.g., "Request changes") since the remote PR hasn't been updated until the autofix push completes
+
+## Worktree Isolation
+
+When reviewing a PR, `/review` creates a temporary git worktree (`.qwen/tmp/review-pr-<number>`) instead of switching your current branch. This means:
+
+- Your working tree, staged changes, and current branch are **never touched**
+- Dependencies are installed in the worktree (`npm ci`, etc.) so linting and build/test work
+- Build and test commands run in isolation without polluting your local build cache
+- If anything goes wrong, your environment is unaffected — just delete the worktree
+- The worktree is automatically cleaned up after the review completes
+- If a review is interrupted (Ctrl+C, crash), the next `/review` of the same PR automatically cleans up the stale worktree before starting fresh
+- Review reports and cache are saved to the main project directory (not the worktree)
+
+## Cross-repo PR Review
+
+You can review PRs from other repositories by passing the full URL:
+
+```bash
+/review https://github.com/other-org/other-repo/pull/456
+```
+
+This runs in **lightweight mode** — no worktree, no linter, no build/test, no autofix. The review is based on the diff text only (fetched via GitHub API). PR comments can still be posted if you have write access.
+
+| Capability                                       | Same-repo | Cross-repo                    |
+| ------------------------------------------------ | --------- | ----------------------------- |
+| LLM review (Agents 1-4 + verify + reverse audit) | ✅        | ✅                            |
+| Agent 5: Build & test                            | ✅        | ❌ (no local codebase)        |
+| Deterministic analysis (linter/typecheck)        | ✅        | ❌                            |
+| Cross-file impact analysis                       | ✅        | ❌                            |
+| Autofix                                          | ✅        | ❌                            |
+| PR inline comments                               | ✅        | ✅ (if you have write access) |
+| Incremental review cache                         | ✅        | ❌                            |
+
+## PR Inline Comments
+
+Use `--comment` to post findings directly on the PR:
+
+```bash
+/review 123 --comment
+```
+
+Or, after running `/review 123`, type `post comments` to publish findings without re-running the review.
+
+**What gets posted:**
+
+- High-confidence Critical and Suggestion findings as inline comments on specific lines
+- For Approve/Request changes verdicts: a review summary with the verdict
+- For Comment verdict with all inline comments posted: no separate summary (inline comments are sufficient)
+- Model attribution footer on each comment (e.g., _— qwen3-coder via Qwen Code /review_)
+
+**What stays terminal-only:**
+
+- Nice to have findings (including linter warnings)
+- Low-confidence findings
+
+## Follow-up Actions
+
+After the review, context-aware tips appear as ghost text. Press Tab to accept:
+
+| State after review                 | Tip                | What happens                            |
+| ---------------------------------- | ------------------ | --------------------------------------- |
+| Local review with unfixed findings | `fix these issues` | LLM interactively fixes each finding    |
+| PR review with findings            | `post comments`    | Posts PR inline comments (no re-review) |
+| PR review, zero findings           | `post comments`    | Approves the PR on GitHub (LGTM)        |
+| Local review, all clear            | `commit`           | Commits your changes                    |
+
+Note: `fix these issues` is only available for local reviews. For PR reviews, use Autofix (Step 8) — the worktree is cleaned up after the review, so post-review interactive fixing is not possible.
+
+## Project Review Rules
+
+You can customize review criteria per project. `/review` reads rules from these files (in order):
+
+1. `.qwen/review-rules.md` (Qwen Code native)
+2. `.github/copilot-instructions.md` (preferred) or `copilot-instructions.md` (fallback — only one is loaded, not both)
+3. `AGENTS.md` — `## Code Review` section
+4. `QWEN.md` — `## Code Review` section
+
+Rules are injected into the LLM review agents (1-4) as additional criteria. For PR reviews, rules are read from the **base branch** to prevent a malicious PR from injecting bypass rules.
+
+Example `.qwen/review-rules.md`:
+
+```markdown
+# Review Rules
+
+- All API endpoints must validate authentication
+- Database queries must use parameterized statements
+- React components must not use inline styles
+- Error messages must not expose internal paths
+```
+
+## Incremental Review
+
+When reviewing a PR that was previously reviewed, `/review` only examines changes since the last review:
+
+```bash
+# First review — full review, cache created
+/review 123
+
+# PR updated with new commits — only new changes reviewed
+/review 123
+```
+
+### Cross-model review
+
+If you switch models (via `/model`) and re-review the same PR, `/review` detects the model change and runs a full review instead of skipping:
+
+```bash
+# Review with model A
+/review 123
+
+# Switch model
+/model
+
+# Review again — full review with model B (not skipped)
+/review 123
+# → "Previous review used qwen3-coder. Running full review with gpt-4o for a second opinion."
+```
+
+Cache is stored in `.qwen/review-cache/` and tracks both the commit SHA and model ID. Make sure this directory is in your `.gitignore` (a broader rule like `.qwen/*` also works). If the cached commit was rebased away, it falls back to a full review.
+
+## Review Reports
+
+For same-repo reviews, results are saved as a Markdown file in your project's `.qwen/reviews/` directory (cross-repo lightweight reviews skip report persistence):
+
+```
+.qwen/reviews/2026-04-06-143022-pr-123.md
+.qwen/reviews/2026-04-06-150510-local.md
+```
+
+Reports include: timestamp, diff stats, deterministic analysis results, all findings with verification status, and the verdict.
+
+## Cross-file Impact Analysis
+
+When code changes modify exported functions, classes, or interfaces, the review agents automatically search for all callers and check compatibility:
+
+- Parameter count/type changes
+- Return type changes
+- Removed or renamed public methods
+- Breaking API changes
+
+For large diffs (>10 modified symbols), analysis prioritizes functions with signature changes.
+
+## Token Efficiency
+
+The review pipeline uses a fixed number of LLM calls regardless of how many findings are produced:
+
+| Stage                           | LLM calls  | Notes                                               |
+| ------------------------------- | ---------- | --------------------------------------------------- |
+| Deterministic analysis (Step 3) | 0          | Shell commands only                                 |
+| Review agents (Step 4)          | 5 (or 4)   | Run in parallel; Agent 5 skipped in cross-repo mode |
+| Batch verification (Step 5)     | 1          | Single agent verifies all findings at once          |
+| Reverse audit (Step 6)          | 1          | Finds coverage gaps; findings skip verification     |
+| **Total**                       | **7 or 6** | Same-repo: 7; cross-repo: 6 (no Agent 5)            |
+
+## What's NOT Flagged
+
+The review intentionally excludes:
+
+- Pre-existing issues in unchanged code (focus on the diff only)
+- Style/formatting/naming that matches your codebase conventions
+- Issues a linter or type checker would catch (handled by deterministic analysis)
+- Subjective "consider doing X" suggestions without a real problem
+- Minor refactoring that doesn't fix a bug or risk
+- Missing documentation unless the logic is genuinely confusing
+- Issues already discussed in existing PR comments (avoids duplicating human feedback)
+
+## Design Philosophy
+
+> **Silence is better than noise.** Every comment should be worth the reader's time.
+
+- If unsure whether something is a problem → don't report it
+- Linter/typecheck issues are handled by tools, not LLM guesses
+- Same pattern across N files → aggregated into one finding
+- PR comments are high-confidence only
+- Style/formatting issues matching codebase conventions are excluded

package/bundled/qc-helper/docs/features/commands.md

@@ -24,6 +24,7 @@ These commands help you save, restore, and summarize work progress.
 | `/summary`  | Generate project summary based on conversation history    | `/summary`                           |
 | `/compress` | Replace chat history with summary to save Tokens          | `/compress`                          |
 | `/resume`   | Resume a previous conversation session                    | `/resume`                            |
+| `/recap`    | Generate a one-line session recap now                     | `/recap`                             |
 | `/restore`  | Restore files to state before tool execution              | `/restore` (list) or `/restore <ID>` |
 
 ### 1.2 Interface and Workspace Control
@@ -34,6 +35,7 @@ Commands for adjusting interface appearance and work environment.
 | ------------ | ---------------------------------------- | ----------------------------- |
 | `/clear`     | Clear terminal screen content            | `/clear` (shortcut: `Ctrl+L`) |
 | `/context`   | Show context window usage breakdown      | `/context`                    |
+| → `detail`   | Show per-item context usage breakdown    | `/context detail`             |
 | `/theme`     | Change Qwen Code visual theme            | `/theme`                      |
 | `/vim`       | Turn input area Vim editing mode on/off  | `/vim`                        |
 | `/directory` | Manage multi-directory support workspace | `/dir add ./src,./tests`      |
@@ -56,22 +58,38 @@ Commands specifically for controlling interface and output language.
 
 Commands for managing AI tools and models.
 
-| Command          | Description                                       | Usage Examples                                |
-| ---------------- | ------------------------------------------------- | --------------------------------------------- |
-| `/mcp`           | List configured MCP servers and tools             | `/mcp`, `/mcp desc`                           |
-| `/tools`         | Display currently available tool list             | `/tools`, `/tools desc`                       |
-| `/skills`        | List and run available skills                     | `/skills`, `/skills <name>`                   |
-| `/approval-mode` | Change approval mode for tool usage               | `/approval-mode <mode (auto-edit)> --project` |
-| →`plan`          | Analysis only, no execution                       | Secure review                                 |
-| →`default`       | Require approval for edits                        | Daily use                                     |
-| →`auto-edit`     | Automatically approve edits                       | Trusted environment                           |
-| →`yolo`          | Automatically approve all                         | Quick prototyping                             |
-| `/model`         | Switch model used in current session              | `/model`                                      |
-| `/model --fast`  | Set or select the fast model for background tasks | `/model --fast qwen3.5-flash`                 |
-| `/extensions`    | List all active extensions in current session     | `/extensions`                                 |
-| `/memory`        | Manage AI's instruction context                   | `/memory add Important Info`                  |
-
-### 1.5 Side Question (`/btw`)
+| Command          | Description                                   | Usage Examples                                |
+| ---------------- | --------------------------------------------- | --------------------------------------------- |
+| `/mcp`           | List configured MCP servers and tools         | `/mcp`, `/mcp desc`                           |
+| `/tools`         | Display currently available tool list         | `/tools`, `/tools desc`                       |
+| `/skills`        | List and run available skills                 | `/skills`, `/skills <name>`                   |
+| `/plan`          | Switch to plan mode or exit plan mode         | `/plan`, `/plan <task>`, `/plan exit`         |
+| `/approval-mode` | Change approval mode for tool usage           | `/approval-mode <mode (auto-edit)> --project` |
+| →`plan`          | Analysis only, no execution                   | Secure review                                 |
+| →`default`       | Require approval for edits                    | Daily use                                     |
+| →`auto-edit`     | Automatically approve edits                   | Trusted environment                           |
+| →`yolo`          | Automatically approve all                     | Quick prototyping                             |
+| `/model`         | Switch model used in current session          | `/model`                                      |
+| `/model --fast`  | Set a lighter model for prompt suggestions    | `/model --fast qwen3-coder-flash`             |
+| `/extensions`    | List all active extensions in current session | `/extensions`                                 |
+| `/memory`        | Open the Memory Manager dialog                | `/memory`                                     |
+| `/remember`      | Save a durable memory                         | `/remember Prefer terse responses`            |
+| `/forget`        | Remove matching entries from auto-memory      | `/forget <query>`                             |
+| `/dream`         | Manually run auto-memory consolidation        | `/dream`                                      |
+
+### 1.5 Built-in Skills
+
+These commands invoke bundled skills that provide specialized workflows.
+
+| Command      | Description                                                         | Usage Examples                                    |
+| ------------ | ------------------------------------------------------------------- | ------------------------------------------------- |
+| `/review`    | Review code changes with 5 parallel agents + deterministic analysis | `/review`, `/review 123`, `/review 123 --comment` |
+| `/loop`      | Run a prompt on a recurring schedule                                | `/loop 5m check the build`                        |
+| `/qc-helper` | Answer questions about Qwen Code usage and configuration            | `/qc-helper how do I configure MCP?`              |
+
+See [Code Review](./code-review.md) for full `/review` documentation.
+
+### 1.6 Side Question (`/btw`)
 
 The `/btw` command allows you to ask quick side questions without interrupting or affecting the main conversation flow.
 
@@ -139,7 +157,58 @@ The `/btw` command allows you to ask quick side questions without interrupting o
 >
 > Use `/btw` when you need a quick answer without derailing your main task. It's especially useful for clarifying concepts, checking facts, or getting quick explanations while staying focused on your primary workflow.
 
-### 1.6 Information, Settings, and Help
+### 1.7 Session Recap (`/recap`)
+
+The `/recap` command generates a short "where you left off" summary of the
+current session, so you can resume an old conversation without scrolling
+back through pages of history.
+
+| Command  | Description                                |
+| -------- | ------------------------------------------ |
+| `/recap` | Generate and show a one-line session recap |
+
+**How it works:**
+
+- Uses the configured fast model (`fastModel` setting) when available, falling
+  back to the main session model. A small, cheap model is enough for a recap.
+- The recent conversation (up to 30 messages, text only — tool calls and tool
+  responses are filtered out) is sent to the model with a tight system prompt.
+- The recap is rendered in dim color with a `❯` prefix so it stands apart
+  from real assistant replies.
+- Refuses with an inline error if a model turn is in flight or another command
+  is processing. If there is no usable conversation, or the underlying
+  generation fails, `/recap` shows a short info message instead of a recap —
+  the manual command always responds with something.
+
+**Auto-trigger when returning from being away:**
+
+If the terminal is blurred for **5+ minutes** and gets focused again, a recap
+is generated and shown automatically (only when no model response is in
+progress; otherwise it waits for the current turn to finish and then fires).
+Unlike the manual command, the auto-trigger is fully silent on failure: if
+generation errors or there is nothing to summarize, no message is added to
+the history. Controlled by the `general.showSessionRecap` setting
+(default: `true`); the manual `/recap` command always works regardless of
+this setting.
+
+**Example:**
+
+```
+> /recap
+
+❯ Refactoring loopDetectionService.ts to address long-session OOM caused by
+  unbounded streamContentHistory and contentStats. The next step is to
+  implement option B (LRU sliding window with FNV-1a) pending confirmation.
+```
+
+> [!tip]
+>
+> Configure a fast model via `/model --fast <model>` (e.g.
+> `qwen3-coder-flash`) to make `/recap` fast and cheap. Set
+> `general.showSessionRecap` to `false` to opt out of the auto-trigger
+> while keeping the manual command available.
+
+### 1.8 Information, Settings, and Help
 
 Commands for obtaining information and performing system settings.
 
@@ -154,7 +223,7 @@ Commands for obtaining information and performing system settings.
 | `/copy`     | Copy last output content to clipboard           | `/copy`                          |
 | `/quit`     | Exit Qwen Code immediately                      | `/quit` or `/exit`               |
 
-### 1.7 Common Shortcuts
+### 1.9 Common Shortcuts
 
 | Shortcut           | Function                | Note                   |
 | ------------------ | ----------------------- | ---------------------- |
@@ -164,17 +233,18 @@ Commands for obtaining information and performing system settings.
 | `Ctrl/cmd+Z`       | Undo input              | Text editing           |
 | `Ctrl/cmd+Shift+Z` | Redo input              | Text editing           |
 
-### 1.8 CLI Auth Subcommands
+### 1.10 CLI Auth Subcommands
 
 In addition to the in-session `/auth` slash command, Qwen Code provides standalone CLI subcommands for managing authentication directly from the terminal:
 
-| Command                                              | Description                                       |
-| ---------------------------------------------------- | ------------------------------------------------- |
-| `qwen auth`                                          | Interactive authentication setup                  |
-| `qwen auth qwen-oauth`                               | Authenticate with Qwen OAuth                      |
-| `qwen auth coding-plan`                              | Authenticate with Alibaba Cloud Coding Plan       |
-| `qwen auth coding-plan --region china --key sk-sp-…` | Non-interactive Coding Plan setup (for scripting) |
-| `qwen auth status`                                   | Show current authentication status                |
+| Command                                              | Description                                                   |
+| ---------------------------------------------------- | ------------------------------------------------------------- |
+| `qwen auth`                                          | Interactive authentication setup                              |
+| `qwen auth coding-plan`                              | Authenticate with Alibaba Cloud Coding Plan                   |
+| `qwen auth coding-plan --region china --key sk-sp-…` | Non-interactive Coding Plan setup (for scripting)             |
+| `qwen auth api-key`                                  | Authenticate with an API key                                  |
+| `qwen auth qwen-oauth`                               | ~~Authenticate with Qwen OAuth~~ (discontinued on 2026-04-15) |
+| `qwen auth status`                                   | Show current authentication status                            |
 
 > [!tip]
 >