@mmmbuto/qwen-code-termux 0.14.3-termux → 0.15.5-termux
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/bundled/batch/SKILL.md +304 -0
- package/bundled/loop/SKILL.md +1 -0
- package/bundled/qc-helper/SKILL.md +1 -0
- package/bundled/qc-helper/docs/configuration/auth.md +13 -6
- package/bundled/qc-helper/docs/configuration/settings.md +158 -109
- package/bundled/qc-helper/docs/features/_meta.ts +4 -0
- package/bundled/qc-helper/docs/features/arena.md +3 -2
- package/bundled/qc-helper/docs/features/commands.md +67 -11
- package/bundled/qc-helper/docs/features/dual-output.md +593 -0
- package/bundled/qc-helper/docs/features/headless.md +61 -0
- package/bundled/qc-helper/docs/features/hooks.md +408 -120
- package/bundled/qc-helper/docs/features/mcp.md +100 -14
- package/bundled/qc-helper/docs/features/memory.md +168 -0
- package/bundled/qc-helper/docs/features/sandbox.md +9 -1
- package/bundled/qc-helper/docs/features/status-line.md +36 -10
- package/bundled/qc-helper/docs/features/sub-agents.md +126 -7
- package/bundled/qc-helper/docs/features/tips.md +54 -0
- package/bundled/qc-helper/docs/features/tool-use-summaries.md +178 -0
- package/bundled/qc-helper/docs/overview.md +4 -4
- package/bundled/qc-helper/docs/quickstart.md +15 -9
- package/bundled/qc-helper/docs/support/tos-privacy.md +1 -1
- package/bundled/qc-helper/docs/support/troubleshooting.md +9 -3
- package/bundled/review/SKILL.md +3 -2
- package/cli.js +241845 -206771
- package/locales/ca.js +2143 -0
- package/locales/de.js +82 -8
- package/locales/en.js +91 -8
- package/locales/fr.js +2099 -0
- package/locales/ja.js +81 -8
- package/locales/pt.js +83 -8
- package/locales/ru.js +81 -8
- package/locales/zh-TW.js +1678 -0
- package/locales/zh.js +88 -8
- package/package.json +2 -2
- package/bundled/qc-helper/docs/configuration/memory.md +0 -0
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> [!tip]
|
|
4
4
|
>
|
|
5
|
-
> **Authentication / API keys:** Authentication (
|
|
5
|
+
> **Authentication / API keys:** Authentication (API Key, Alibaba Cloud Coding Plan) and auth-related environment variables (like `OPENAI_API_KEY`) are documented in **[Authentication](../configuration/auth)**.
|
|
6
6
|
|
|
7
7
|
> [!note]
|
|
8
8
|
>
|
|
@@ -77,14 +77,16 @@ Settings are organized into categories. All settings should be placed within the
|
|
|
77
77
|
|
|
78
78
|
#### general
|
|
79
79
|
|
|
80
|
-
| Setting
|
|
81
|
-
|
|
|
82
|
-
| `general.preferredEditor`
|
|
83
|
-
| `general.vimMode`
|
|
84
|
-
| `general.enableAutoUpdate`
|
|
85
|
-
| `general.
|
|
86
|
-
| `general.
|
|
87
|
-
| `general.
|
|
80
|
+
| Setting | Type | Description | Default |
|
|
81
|
+
| ------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
|
|
82
|
+
| `general.preferredEditor` | string | The preferred editor to open files in. | `undefined` |
|
|
83
|
+
| `general.vimMode` | boolean | Enable Vim keybindings. | `false` |
|
|
84
|
+
| `general.enableAutoUpdate` | boolean | Enable automatic update checks and installations on startup. | `true` |
|
|
85
|
+
| `general.showSessionRecap` | boolean | Auto-show a one-line "where you left off" recap when returning to the terminal after being away. Off by default. Use `/recap` to trigger manually regardless of this setting. | `false` |
|
|
86
|
+
| `general.sessionRecapAwayThresholdMinutes` | number | Minutes the terminal must be blurred before an auto-recap fires on focus-in. Only used when `showSessionRecap` is enabled. | `5` |
|
|
87
|
+
| `general.gitCoAuthor` | boolean | Automatically add a Co-authored-by trailer to git commit messages when commits are made through Qwen Code. | `true` |
|
|
88
|
+
| `general.checkpointing.enabled` | boolean | Enable session checkpointing for recovery. | `false` |
|
|
89
|
+
| `general.defaultFileEncoding` | string | Default encoding for new files. Use `"utf-8"` (default) for UTF-8 without BOM, or `"utf-8-bom"` for UTF-8 with BOM. Only change this if your project specifically requires BOM. | `"utf-8"` |
|
|
88
90
|
|
|
89
91
|
#### output
|
|
90
92
|
|
|
@@ -94,26 +96,28 @@ Settings are organized into categories. All settings should be placed within the
|
|
|
94
96
|
|
|
95
97
|
#### ui
|
|
96
98
|
|
|
97
|
-
| Setting | Type | Description
|
|
98
|
-
| --------------------------------------- | ---------------- |
|
|
99
|
-
| `ui.theme` | string | The color theme for the UI. See [Themes](../configuration/themes) for available options.
|
|
100
|
-
| `ui.customThemes` | object | Custom theme definitions.
|
|
101
|
-
| `ui.statusLine` | object | Custom status line configuration. A shell command whose output is shown in the footer's left section. See [Status Line](../features/status-line).
|
|
102
|
-
| `ui.hideWindowTitle` | boolean | Hide the window title bar.
|
|
103
|
-
| `ui.hideTips` | boolean | Hide
|
|
104
|
-
| `ui.hideBanner` | boolean | Hide the application banner.
|
|
105
|
-
| `ui.hideFooter` | boolean | Hide the footer from the UI.
|
|
106
|
-
| `ui.showMemoryUsage` | boolean | Display memory usage information in the UI.
|
|
107
|
-
| `ui.showLineNumbers` | boolean | Show line numbers in code blocks in the CLI output.
|
|
108
|
-
| `ui.showCitations` | boolean | Show citations for generated text in the chat.
|
|
109
|
-
| `ui.compactMode` | boolean | Hide tool output and thinking for a cleaner view. Toggle with `Ctrl+O` during a session.
|
|
110
|
-
| `
|
|
111
|
-
| `
|
|
112
|
-
| `ui.accessibility.
|
|
113
|
-
| `ui.
|
|
114
|
-
| `ui.
|
|
115
|
-
| `ui.
|
|
116
|
-
| `ui.
|
|
99
|
+
| Setting | Type | Description | Default |
|
|
100
|
+
| --------------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
|
|
101
|
+
| `ui.theme` | string | The color theme for the UI. See [Themes](../configuration/themes) for available options. | `undefined` |
|
|
102
|
+
| `ui.customThemes` | object | Custom theme definitions. | `{}` |
|
|
103
|
+
| `ui.statusLine` | object | Custom status line configuration. A shell command whose output is shown in the footer's left section. See [Status Line](../features/status-line). | `undefined` |
|
|
104
|
+
| `ui.hideWindowTitle` | boolean | Hide the window title bar. | `false` |
|
|
105
|
+
| `ui.hideTips` | boolean | Hide all tips (startup and post-response) in the UI. See [Contextual Tips](../features/tips). | `false` |
|
|
106
|
+
| `ui.hideBanner` | boolean | Hide the application banner. | `false` |
|
|
107
|
+
| `ui.hideFooter` | boolean | Hide the footer from the UI. | `false` |
|
|
108
|
+
| `ui.showMemoryUsage` | boolean | Display memory usage information in the UI. | `false` |
|
|
109
|
+
| `ui.showLineNumbers` | boolean | Show line numbers in code blocks in the CLI output. | `true` |
|
|
110
|
+
| `ui.showCitations` | boolean | Show citations for generated text in the chat. | `true` |
|
|
111
|
+
| `ui.compactMode` | boolean | Hide tool output and thinking for a cleaner view. Toggle with `Ctrl+O` during a session or via the Settings dialog. Tool approval prompts are never hidden, even in compact mode. The setting persists across sessions. | `false` |
|
|
112
|
+
| `ui.shellOutputMaxLines` | number | Max number of shell output lines shown inline. Set to `0` to disable the cap and show full output. Hidden lines are surfaced via the `+N lines` indicator. Errors, `!`-prefix user-initiated commands, confirming tools, and focused embedded shells always show full output. | `5` |
|
|
113
|
+
| `enableWelcomeBack` | boolean | Show welcome back dialog when returning to a project with conversation history. When enabled, Qwen Code will automatically detect if you're returning to a project with a previously generated project summary (`.qwen/PROJECT_SUMMARY.md`) and show a dialog allowing you to continue your previous conversation or start fresh. If you choose **Start new chat session**, that choice is remembered for the current project until the project summary changes. This feature integrates with the `/summary` command and quit confirmation dialog. | `true` |
|
|
114
|
+
| `ui.accessibility.enableLoadingPhrases` | boolean | Enable loading phrases (disable for accessibility). | `true` |
|
|
115
|
+
| `ui.accessibility.screenReader` | boolean | Enables screen reader mode, which adjusts the TUI for better compatibility with screen readers. | `false` |
|
|
116
|
+
| `ui.customWittyPhrases` | array of strings | A list of custom phrases to display during loading states. When provided, the CLI will cycle through these phrases instead of the default ones. | `[]` |
|
|
117
|
+
| `ui.enableFollowupSuggestions` | boolean | Enable [followup suggestions](../features/followup-suggestions) that predict what you want to type next after the model responds. Suggestions appear as ghost text and can be accepted with Tab, Enter, or Right Arrow. | `true` |
|
|
118
|
+
| `ui.enableCacheSharing` | boolean | Use cache-aware forked queries for suggestion generation. Reduces cost on providers that support prefix caching (experimental). | `true` |
|
|
119
|
+
| `ui.enableSpeculation` | boolean | Speculatively execute accepted suggestions before submission. Results appear instantly when you accept (experimental). | `false` |
|
|
120
|
+
| `experimental.emitToolUseSummaries` | boolean | Generate short LLM-based labels summarizing each tool-call batch. See [Tool-Use Summaries](../features/tool-use-summaries). Requires `fastModel` to be configured; silently skipped otherwise. Can be overridden per-session with `QWEN_CODE_EMIT_TOOL_USE_SUMMARIES=0` or `=1`. | `true` |
|
|
117
121
|
|
|
118
122
|
#### ide
|
|
119
123
|
|
|
@@ -130,17 +134,17 @@ Settings are organized into categories. All settings should be placed within the
|
|
|
130
134
|
|
|
131
135
|
#### model
|
|
132
136
|
|
|
133
|
-
| Setting | Type | Description
|
|
134
|
-
| -------------------------------------------------- | ------- |
|
|
135
|
-
| `model.name` | string | The Qwen model to use for conversations.
|
|
136
|
-
| `model.maxSessionTurns` | number | Maximum number of user/model/tool turns to keep in a session. -1 means unlimited.
|
|
137
|
-
| `model.generationConfig` | object | Advanced overrides passed to the underlying content generator. Supports request controls such as `timeout`, `maxRetries`, `enableCacheControl`, `contextWindowSize` (override model's context window size), `modalities` (override auto-detected input modalities), `customHeaders` (custom HTTP headers for API requests), and `extra_body` (additional body parameters for OpenAI-compatible API requests only), along with fine-tuning knobs under `samplingParams` (for example `temperature`, `top_p`, `max_tokens`). Leave unset to rely on provider defaults. | `undefined` |
|
|
138
|
-
| `model.chatCompression.contextPercentageThreshold` | number | Sets the threshold for chat history compression as a percentage of the model's total token limit. This is a value between 0 and 1 that applies to both automatic compression and the manual `/compress` command. For example, a value of `0.6` will trigger compression when the chat history exceeds 60% of the token limit. Use `0` to disable compression entirely.
|
|
139
|
-
| `model.skipNextSpeakerCheck` | boolean | Skip the next speaker check.
|
|
140
|
-
| `model.skipLoopDetection` | boolean | Disables loop detection checks. Loop detection prevents infinite loops in AI responses but can generate false positives that interrupt legitimate workflows. Enable this option if you experience frequent false positive loop detection interruptions.
|
|
141
|
-
| `model.skipStartupContext` | boolean | Skips sending the startup workspace context (environment summary and acknowledgement) at the beginning of each session. Enable this if you prefer to provide context manually or want to save tokens on startup.
|
|
142
|
-
| `model.enableOpenAILogging` | boolean | Enables logging of OpenAI API calls for debugging and analysis. When enabled, API requests and responses are logged to JSON files.
|
|
143
|
-
| `model.openAILoggingDir` | string | Custom directory path for OpenAI API logs. If not specified, defaults to `logs/openai` in the current working directory. Supports absolute paths, relative paths (resolved from current working directory), and `~` expansion (home directory).
|
|
137
|
+
| Setting | Type | Description | Default |
|
|
138
|
+
| -------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
|
|
139
|
+
| `model.name` | string | The Qwen model to use for conversations. | `undefined` |
|
|
140
|
+
| `model.maxSessionTurns` | number | Maximum number of user/model/tool turns to keep in a session. -1 means unlimited. | `-1` |
|
|
141
|
+
| `model.generationConfig` | object | Advanced overrides passed to the underlying content generator. Supports request controls such as `timeout`, `maxRetries`, `enableCacheControl`, `splitToolMedia` (set `true` for strict OpenAI-compatible servers like LM Studio that reject non-text content on `role: "tool"` messages — splits media into a follow-up user message), `contextWindowSize` (override model's context window size), `modalities` (override auto-detected input modalities), `customHeaders` (custom HTTP headers for API requests), and `extra_body` (additional body parameters for OpenAI-compatible API requests only), along with fine-tuning knobs under `samplingParams` (for example `temperature`, `top_p`, `max_tokens`). Leave unset to rely on provider defaults. | `undefined` |
|
|
142
|
+
| `model.chatCompression.contextPercentageThreshold` | number | Sets the threshold for chat history compression as a percentage of the model's total token limit. This is a value between 0 and 1 that applies to both automatic compression and the manual `/compress` command. For example, a value of `0.6` will trigger compression when the chat history exceeds 60% of the token limit. Use `0` to disable compression entirely. | `0.7` |
|
|
143
|
+
| `model.skipNextSpeakerCheck` | boolean | Skip the next speaker check. | `false` |
|
|
144
|
+
| `model.skipLoopDetection` | boolean | Disables loop detection checks. Loop detection prevents infinite loops in AI responses but can generate false positives that interrupt legitimate workflows. Enable this option if you experience frequent false positive loop detection interruptions. | `false` |
|
|
145
|
+
| `model.skipStartupContext` | boolean | Skips sending the startup workspace context (environment summary and acknowledgement) at the beginning of each session. Enable this if you prefer to provide context manually or want to save tokens on startup. | `false` |
|
|
146
|
+
| `model.enableOpenAILogging` | boolean | Enables logging of OpenAI API calls for debugging and analysis. When enabled, API requests and responses are logged to JSON files. | `false` |
|
|
147
|
+
| `model.openAILoggingDir` | string | Custom directory path for OpenAI API logs. If not specified, defaults to `logs/openai` in the current working directory. Supports absolute paths, relative paths (resolved from current working directory), and `~` expansion (home directory). | `undefined` |
|
|
144
148
|
|
|
145
149
|
**Example model.generationConfig:**
|
|
146
150
|
|
|
@@ -210,17 +214,18 @@ The `extra_body` field allows you to add custom parameters to the request body s
|
|
|
210
214
|
|
|
211
215
|
#### context
|
|
212
216
|
|
|
213
|
-
| Setting
|
|
214
|
-
|
|
|
215
|
-
| `context.fileName`
|
|
216
|
-
| `context.importFormat`
|
|
217
|
-
| `context.includeDirectories`
|
|
218
|
-
| `context.loadFromIncludeDirectories`
|
|
219
|
-
| `context.fileFiltering.respectGitIgnore`
|
|
220
|
-
| `context.fileFiltering.respectQwenIgnore`
|
|
221
|
-
| `context.fileFiltering.enableRecursiveFileSearch`
|
|
222
|
-
| `context.fileFiltering.enableFuzzySearch`
|
|
223
|
-
| `context.
|
|
217
|
+
| Setting | Type | Description | Default |
|
|
218
|
+
| -------------------------------------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
|
|
219
|
+
| `context.fileName` | string or array of strings | The name of the context file(s). | `undefined` |
|
|
220
|
+
| `context.importFormat` | string | The format to use when importing memory. | `undefined` |
|
|
221
|
+
| `context.includeDirectories` | array | Additional directories to include in the workspace context. Specifies an array of additional absolute or relative paths to include in the workspace context. Missing directories will be skipped with a warning by default. Paths can use `~` to refer to the user's home directory. This setting can be combined with the `--include-directories` command-line flag. | `[]` |
|
|
222
|
+
| `context.loadFromIncludeDirectories` | boolean | Controls the behavior of the `/memory refresh` command. If set to `true`, `QWEN.md` files should be loaded from all directories that are added. If set to `false`, `QWEN.md` should only be loaded from the current directory. | `false` |
|
|
223
|
+
| `context.fileFiltering.respectGitIgnore` | boolean | Respect .gitignore files when searching. | `true` |
|
|
224
|
+
| `context.fileFiltering.respectQwenIgnore` | boolean | Respect .qwenignore files when searching. | `true` |
|
|
225
|
+
| `context.fileFiltering.enableRecursiveFileSearch` | boolean | Whether to enable searching recursively for filenames under the current tree when completing `@` prefixes in the prompt. | `true` |
|
|
226
|
+
| `context.fileFiltering.enableFuzzySearch` | boolean | When `true`, enables fuzzy search capabilities when searching for files. Set to `false` to improve performance on projects with a large number of files. | `true` |
|
|
227
|
+
| `context.clearContextOnIdle.toolResultsThresholdMinutes` | number | Minutes of inactivity before clearing old tool result content. Use `-1` to disable. | `60` |
|
|
228
|
+
| `context.clearContextOnIdle.toolResultsNumToKeep` | number | Number of most-recent compactable tool results to preserve when clearing. Floor at 1. | `5` |
|
|
224
229
|
|
|
225
230
|
#### Troubleshooting File Search Performance
|
|
226
231
|
|
|
@@ -235,6 +240,7 @@ If you are experiencing performance issues with file searching (e.g., with `@` c
|
|
|
235
240
|
| Setting | Type | Description | Default | Notes |
|
|
236
241
|
| ------------------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
237
242
|
| `tools.sandbox` | boolean or string | Sandbox execution environment (can be a boolean or a path string). | `undefined` | |
|
|
243
|
+
| `tools.sandboxImage` | string | Sandbox image URI used by Docker/Podman when `--sandbox-image` and `QWEN_SANDBOX_IMAGE` are not set. | `undefined` | |
|
|
238
244
|
| `tools.shell.enableInteractiveShell` | boolean | Use `node-pty` for an interactive shell experience. Fallback to `child_process` still applies. | `false` | |
|
|
239
245
|
| `tools.core` | array of strings | **Deprecated.** Will be removed in next version. Use `permissions.allow` + `permissions.deny` instead. Restricts built-in tools to an allowlist. All tools not in the list are disabled. | `undefined` | |
|
|
240
246
|
| `tools.exclude` | array of strings | **Deprecated.** Use `permissions.deny` instead. Tool names to exclude from discovery. Automatically migrated to the `permissions` format on first load. | `undefined` | |
|
|
@@ -251,6 +257,15 @@ If you are experiencing performance issues with file searching (e.g., with `@` c
|
|
|
251
257
|
>
|
|
252
258
|
> **Migrating from `tools.core` / `tools.exclude` / `tools.allowed`:** These legacy settings are **deprecated** and automatically migrated to the new `permissions` format on first load. Prefer configuring `permissions.allow` / `permissions.deny` directly. Use `/permissions` to manage rules interactively.
|
|
253
259
|
|
|
260
|
+
#### memory
|
|
261
|
+
|
|
262
|
+
| Setting | Type | Description | Default |
|
|
263
|
+
| -------------------------------- | ------- | --------------------------------------------------------------------------------- | ------- |
|
|
264
|
+
| `memory.enableManagedAutoMemory` | boolean | Enable background extraction of memories from conversations. | `true` |
|
|
265
|
+
| `memory.enableManagedAutoDream` | boolean | Enable automatic consolidation (deduplication and cleanup) of collected memories. | `false` |
|
|
266
|
+
|
|
267
|
+
See [Memory](../features/memory) for details on how auto-memory works and how to use the `/memory`, `/remember`, and `/dream` commands.
|
|
268
|
+
|
|
254
269
|
#### permissions
|
|
255
270
|
|
|
256
271
|
The permissions system provides fine-grained control over which tools can run, which require confirmation, and which are blocked.
|
|
@@ -344,6 +359,39 @@ Permission rules for `Read`, `Edit`, and `WebFetch` are also enforced when the a
|
|
|
344
359
|
> [!tip]
|
|
345
360
|
> Use `/permissions` in the interactive CLI to view, add, and remove rules without editing `settings.json` directly.
|
|
346
361
|
|
|
362
|
+
#### slashCommands
|
|
363
|
+
|
|
364
|
+
Controls which slash commands are available in the CLI. Useful for locking down
|
|
365
|
+
the command surface in multi-tenant or enterprise deployments.
|
|
366
|
+
|
|
367
|
+
| Setting | Type | Description | Default |
|
|
368
|
+
| ------------------------ | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
|
|
369
|
+
| `slashCommands.disabled` | array of strings | Slash command names to hide and refuse to execute. Matched case-insensitively against the final command name (for extension commands this is the disambiguated form, e.g. `myext.deploy`). **Merged as a union across scopes**, so workspace settings can add to but not remove entries defined in user or system settings. | `undefined` |
|
|
370
|
+
|
|
371
|
+
The same denylist can also be provided via the `--disabled-slash-commands` CLI
|
|
372
|
+
flag (comma-separated or repeated) and the `QWEN_DISABLED_SLASH_COMMANDS`
|
|
373
|
+
environment variable; values from all three sources are unioned together.
|
|
374
|
+
|
|
375
|
+
**Example — lock down built-ins for a sandboxed deployment:**
|
|
376
|
+
|
|
377
|
+
```json
|
|
378
|
+
{
|
|
379
|
+
"slashCommands": {
|
|
380
|
+
"disabled": ["auth", "mcp", "extensions", "ide", "quit"]
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
```
|
|
384
|
+
|
|
385
|
+
With these values in a system-level `settings.json` (`/etc/qwen-code/settings.json`
|
|
386
|
+
or `QWEN_CODE_SYSTEM_SETTINGS_PATH`), users cannot shrink the denylist from
|
|
387
|
+
their own scope, and the disabled commands will not appear in autocomplete or
|
|
388
|
+
execute when typed.
|
|
389
|
+
|
|
390
|
+
> [!note]
|
|
391
|
+
> This setting only gates slash commands (e.g. `/auth`, `/mcp`). It does not
|
|
392
|
+
> affect tool permissions — see `permissions.deny` for that. It also does not
|
|
393
|
+
> intercept keyboard shortcuts such as `Ctrl+C` or `Esc`.
|
|
394
|
+
|
|
347
395
|
#### mcp
|
|
348
396
|
|
|
349
397
|
| Setting | Type | Description | Default |
|
|
@@ -382,11 +430,6 @@ LSP server configuration is done through `.lsp.json` files in your project root
|
|
|
382
430
|
| `advanced.dnsResolutionOrder` | string | The DNS resolution order. | `undefined` |
|
|
383
431
|
| `advanced.excludedEnvVars` | array of strings | Environment variables to exclude from project context. Specifies environment variables that should be excluded from being loaded from project `.env` files. This prevents project-specific environment variables (like `DEBUG=true`) from interfering with the CLI behavior. Variables from `.qwen/.env` files are never excluded. | `["DEBUG","DEBUG_MODE"]` |
|
|
384
432
|
| `advanced.bugCommand` | object | Configuration for the bug report command. Overrides the default URL for the `/bug` command. Properties: `urlTemplate` (string): A URL that can contain `{title}` and `{info}` placeholders. Example: `"bugCommand": { "urlTemplate": "https://bug.example.com/new?title={title}&info={info}" }` | `undefined` |
|
|
385
|
-
| `advanced.tavilyApiKey` | string | API key for Tavily web search service. Used to enable the `web_search` tool functionality. | `undefined` |
|
|
386
|
-
|
|
387
|
-
> [!note]
|
|
388
|
-
>
|
|
389
|
-
> **Note about advanced.tavilyApiKey:** This is a legacy configuration format. For Qwen OAuth users, DashScope provider is automatically available without any configuration. For other authentication types, configure Tavily or Google providers using the new `webSearch` configuration format.
|
|
390
433
|
|
|
391
434
|
#### mcpServers
|
|
392
435
|
|
|
@@ -442,6 +485,7 @@ Here is an example of a `settings.json` file with the nested structure, new as o
|
|
|
442
485
|
"tools": {
|
|
443
486
|
"approvalMode": "yolo",
|
|
444
487
|
"sandbox": "docker",
|
|
488
|
+
"sandboxImage": "ghcr.io/qwenlm/qwen-code:0.14.1",
|
|
445
489
|
"discoveryCommand": "bin/get_tools",
|
|
446
490
|
"callCommand": "bin/call_tool",
|
|
447
491
|
"exclude": ["write_file"]
|
|
@@ -505,66 +549,71 @@ For authentication-related variables (like `OPENAI_*`) and the recommended `.qwe
|
|
|
505
549
|
|
|
506
550
|
### Environment Variables Table
|
|
507
551
|
|
|
508
|
-
| Variable | Description
|
|
509
|
-
| ------------------------------ |
|
|
510
|
-
| `QWEN_TELEMETRY_ENABLED` | Set to `true` or `1` to enable telemetry. Any other value is treated as disabling it.
|
|
511
|
-
| `QWEN_TELEMETRY_TARGET` | Sets the telemetry target (`local` or `gcp`).
|
|
512
|
-
| `QWEN_TELEMETRY_OTLP_ENDPOINT` | Sets the OTLP endpoint for telemetry.
|
|
513
|
-
| `QWEN_TELEMETRY_OTLP_PROTOCOL` | Sets the OTLP protocol (`grpc` or `http`).
|
|
514
|
-
| `QWEN_TELEMETRY_LOG_PROMPTS` | Set to `true` or `1` to enable or disable logging of user prompts. Any other value is treated as disabling it.
|
|
515
|
-
| `QWEN_TELEMETRY_OUTFILE` | Sets the file path to write telemetry to when the target is `local`.
|
|
516
|
-
| `QWEN_TELEMETRY_USE_COLLECTOR` | Set to `true` or `1` to enable or disable using an external OTLP collector. Any other value is treated as disabling it.
|
|
517
|
-
| `QWEN_SANDBOX` | Alternative to the `sandbox` setting in `settings.json`.
|
|
518
|
-
| `
|
|
519
|
-
| `
|
|
520
|
-
| `
|
|
521
|
-
| `
|
|
522
|
-
| `
|
|
523
|
-
| `
|
|
524
|
-
| `
|
|
552
|
+
| Variable | Description | Notes |
|
|
553
|
+
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
554
|
+
| `QWEN_TELEMETRY_ENABLED` | Set to `true` or `1` to enable telemetry. Any other value is treated as disabling it. | Overrides the `telemetry.enabled` setting. |
|
|
555
|
+
| `QWEN_TELEMETRY_TARGET` | Sets the telemetry target (`local` or `gcp`). | Overrides the `telemetry.target` setting. |
|
|
556
|
+
| `QWEN_TELEMETRY_OTLP_ENDPOINT` | Sets the OTLP endpoint for telemetry. | Overrides the `telemetry.otlpEndpoint` setting. |
|
|
557
|
+
| `QWEN_TELEMETRY_OTLP_PROTOCOL` | Sets the OTLP protocol (`grpc` or `http`). | Overrides the `telemetry.otlpProtocol` setting. |
|
|
558
|
+
| `QWEN_TELEMETRY_LOG_PROMPTS` | Set to `true` or `1` to enable or disable logging of user prompts. Any other value is treated as disabling it. | Overrides the `telemetry.logPrompts` setting. |
|
|
559
|
+
| `QWEN_TELEMETRY_OUTFILE` | Sets the file path to write telemetry to when the target is `local`. | Overrides the `telemetry.outfile` setting. |
|
|
560
|
+
| `QWEN_TELEMETRY_USE_COLLECTOR` | Set to `true` or `1` to enable or disable using an external OTLP collector. Any other value is treated as disabling it. | Overrides the `telemetry.useCollector` setting. |
|
|
561
|
+
| `QWEN_SANDBOX` | Alternative to the `sandbox` setting in `settings.json`. | Accepts `true`, `false`, `docker`, `podman`, or a custom command string. |
|
|
562
|
+
| `QWEN_SANDBOX_IMAGE` | Overrides sandbox image selection for Docker/Podman. | Takes precedence over `tools.sandboxImage`. |
|
|
563
|
+
| `SEATBELT_PROFILE` | (macOS specific) Switches the Seatbelt (`sandbox-exec`) profile on macOS. | `permissive-open`: (Default) Restricts writes to the project folder (and a few other folders, see `packages/cli/src/utils/sandbox-macos-permissive-open.sb`) but allows other operations. `strict`: Uses a strict profile that declines operations by default. `<profile_name>`: Uses a custom profile. To define a custom profile, create a file named `sandbox-macos-<profile_name>.sb` in your project's `.qwen/` directory (e.g., `my-project/.qwen/sandbox-macos-custom.sb`). |
|
|
564
|
+
| `DEBUG` or `DEBUG_MODE` | (often used by underlying libraries or the CLI itself) Set to `true` or `1` to enable verbose debug logging, which can be helpful for troubleshooting. | **Note:** These variables are automatically excluded from project `.env` files by default to prevent interference with the CLI behavior. Use `.qwen/.env` files if you need to set these for Qwen Code specifically. |
|
|
565
|
+
| `NO_COLOR` | Set to any value to disable all color output in the CLI. | |
|
|
566
|
+
| `CLI_TITLE` | Set to a string to customize the title of the CLI. | |
|
|
567
|
+
| `CODE_ASSIST_ENDPOINT` | Specifies the endpoint for the code assist server. | This is useful for development and testing. |
|
|
568
|
+
| `QWEN_CODE_MAX_OUTPUT_TOKENS` | Overrides the default maximum output tokens per response. When not set, Qwen Code uses an adaptive strategy: starts with 8K tokens and automatically retries with 64K if the response is truncated. Set this to a specific value (e.g., `16000`) to use a fixed limit instead. | Takes precedence over the capped default (8K) but is overridden by `samplingParams.max_tokens` in settings. Disables automatic escalation when set. Example: `export QWEN_CODE_MAX_OUTPUT_TOKENS=16000` |
|
|
569
|
+
| `QWEN_CODE_UNATTENDED_RETRY` | Set to `true` or `1` to enable persistent retry mode. When enabled, transient API capacity errors (HTTP 429 Rate Limit and 529 Overloaded) are retried indefinitely with exponential backoff (capped at 5 minutes per retry) and heartbeat keepalives every 30 seconds on stderr. | Designed for CI/CD pipelines and background automation where long-running tasks should survive temporary API outages. Must be set explicitly — `CI=true` alone does **not** activate this mode. See [Headless Mode](../features/headless#persistent-retry-mode) for details. Example: `export QWEN_CODE_UNATTENDED_RETRY=1` |
|
|
570
|
+
| `QWEN_CODE_PROFILE_STARTUP` | Set to `1` to enable startup performance profiling. Writes a JSON timing report to `~/.qwen/startup-perf/` with per-phase durations. | Only active inside the sandbox child process. Zero overhead when not set. Example: `export QWEN_CODE_PROFILE_STARTUP=1` |
|
|
525
571
|
|
|
526
572
|
## Command-Line Arguments
|
|
527
573
|
|
|
528
574
|
Arguments passed directly when running the CLI can override other configurations for that specific session.
|
|
529
575
|
|
|
576
|
+
For sandbox image selection, precedence is:
|
|
577
|
+
`--sandbox-image` > `QWEN_SANDBOX_IMAGE` > `tools.sandboxImage` > built-in default image.
|
|
578
|
+
|
|
530
579
|
### Command-Line Arguments Table
|
|
531
580
|
|
|
532
|
-
| Argument | Alias | Description
|
|
533
|
-
| ---------------------------- | ----- |
|
|
534
|
-
| `--model` | `-m` | Specifies the Qwen model to use for this session.
|
|
535
|
-
| `--prompt` | `-p` | Used to pass a prompt directly to the command. This invokes Qwen Code in a non-interactive mode.
|
|
536
|
-
| `--prompt-interactive` | `-i` | Starts an interactive session with the provided prompt as the initial input.
|
|
537
|
-
| `--system-prompt` | | Overrides the built-in main session system prompt for this run.
|
|
538
|
-
| `--append-system-prompt` | | Appends extra instructions to the main session system prompt for this run.
|
|
539
|
-
| `--output-format` | `-o` | Specifies the format of the CLI output for non-interactive mode.
|
|
540
|
-
| `--input-format` | | Specifies the format consumed from standard input.
|
|
541
|
-
| `--include-partial-messages` | | Include partial assistant messages when using `stream-json` output format. When enabled, emits stream events (message_start, content_block_delta, etc.) as they occur during streaming.
|
|
542
|
-
| `--sandbox` | `-s` | Enables sandbox mode for this session.
|
|
543
|
-
| `--sandbox-image` | | Sets the sandbox image URI.
|
|
544
|
-
| `--debug` | `-d` | Enables debug mode for this session, providing more verbose output.
|
|
545
|
-
| `--all-files` | `-a` | If set, recursively includes all files within the current directory as context for the prompt.
|
|
546
|
-
| `--help` | `-h` | Displays help information about command-line arguments.
|
|
547
|
-
| `--show-memory-usage` | | Displays the current memory usage.
|
|
548
|
-
| `--yolo` | | Enables YOLO mode, which automatically approves all tool calls.
|
|
549
|
-
| `--approval-mode` | | Sets the approval mode for tool calls.
|
|
550
|
-
| `--allowed-tools` | | A comma-separated list of tool names that will bypass the confirmation dialog.
|
|
551
|
-
| `--
|
|
552
|
-
| `--telemetry
|
|
553
|
-
| `--telemetry-
|
|
554
|
-
| `--telemetry-otlp-
|
|
555
|
-
| `--telemetry-
|
|
556
|
-
| `--
|
|
557
|
-
| `--
|
|
558
|
-
| `--
|
|
559
|
-
| `--
|
|
560
|
-
| `--
|
|
561
|
-
| `--
|
|
562
|
-
| `--
|
|
563
|
-
| `--
|
|
564
|
-
| `--
|
|
565
|
-
| `--
|
|
566
|
-
| `--openai-logging
|
|
567
|
-
| `--
|
|
581
|
+
| Argument | Alias | Description | Possible Values | Notes |
|
|
582
|
+
| ---------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
583
|
+
| `--model` | `-m` | Specifies the Qwen model to use for this session. | Model name | Example: `npm start -- --model qwen3-coder-plus` |
|
|
584
|
+
| `--prompt` | `-p` | Used to pass a prompt directly to the command. This invokes Qwen Code in a non-interactive mode. | Your prompt text | For scripting examples, use the `--output-format json` flag to get structured output. |
|
|
585
|
+
| `--prompt-interactive` | `-i` | Starts an interactive session with the provided prompt as the initial input. | Your prompt text | The prompt is processed within the interactive session, not before it. Cannot be used when piping input from stdin. Example: `qwen -i "explain this code"` |
|
|
586
|
+
| `--system-prompt` | | Overrides the built-in main session system prompt for this run. | Your prompt text | Loaded context files such as `QWEN.md` are still appended after this override. Can be combined with `--append-system-prompt`. |
|
|
587
|
+
| `--append-system-prompt` | | Appends extra instructions to the main session system prompt for this run. | Your prompt text | Applied after the built-in prompt and loaded context files. Can be combined with `--system-prompt`. See [Headless Mode](../features/headless) for examples. |
|
|
588
|
+
| `--output-format` | `-o` | Specifies the format of the CLI output for non-interactive mode. | `text`, `json`, `stream-json` | `text`: (Default) The standard human-readable output. `json`: A machine-readable JSON output emitted at the end of execution. `stream-json`: Streaming JSON messages emitted as they occur during execution. For structured output and scripting, use the `--output-format json` or `--output-format stream-json` flag. See [Headless Mode](../features/headless) for detailed information. |
|
|
589
|
+
| `--input-format` | | Specifies the format consumed from standard input. | `text`, `stream-json` | `text`: (Default) Standard text input from stdin or command-line arguments. `stream-json`: JSON message protocol via stdin for bidirectional communication. Requirement: `--input-format stream-json` requires `--output-format stream-json` to be set. When using `stream-json`, stdin is reserved for protocol messages. See [Headless Mode](../features/headless) for detailed information. |
|
|
590
|
+
| `--include-partial-messages` | | Include partial assistant messages when using `stream-json` output format. When enabled, emits stream events (message_start, content_block_delta, etc.) as they occur during streaming. | | Default: `false`. Requirement: Requires `--output-format stream-json` to be set. See [Headless Mode](../features/headless) for detailed information about stream events. |
|
|
591
|
+
| `--sandbox` | `-s` | Enables sandbox mode for this session. | | |
|
|
592
|
+
| `--sandbox-image` | | Sets the sandbox image URI. | | |
|
|
593
|
+
| `--debug` | `-d` | Enables debug mode for this session, providing more verbose output. | | |
|
|
594
|
+
| `--all-files` | `-a` | If set, recursively includes all files within the current directory as context for the prompt. | | |
|
|
595
|
+
| `--help` | `-h` | Displays help information about command-line arguments. | | |
|
|
596
|
+
| `--show-memory-usage` | | Displays the current memory usage. | | |
|
|
597
|
+
| `--yolo` | | Enables YOLO mode, which automatically approves all tool calls. | | |
|
|
598
|
+
| `--approval-mode` | | Sets the approval mode for tool calls. | `plan`, `default`, `auto-edit`, `yolo` | Supported modes: `plan`: Analyze only—do not modify files or execute commands. `default`: Require approval for file edits or shell commands (default behavior). `auto-edit`: Automatically approve edit tools (edit, write_file) while prompting for others. `yolo`: Automatically approve all tool calls (equivalent to `--yolo`). Cannot be used together with `--yolo`. Use `--approval-mode=yolo` instead of `--yolo` for the new unified approach. Example: `qwen --approval-mode auto-edit`<br>See more about [Approval Mode](../features/approval-mode). |
|
|
599
|
+
| `--allowed-tools` | | A comma-separated list of tool names that will bypass the confirmation dialog. | Tool names | Example: `qwen --allowed-tools "Shell(git status)"` |
|
|
600
|
+
| `--disabled-slash-commands` | | Slash command names to hide/disable (comma-separated or repeated). Unioned with the `slashCommands.disabled` setting and the `QWEN_DISABLED_SLASH_COMMANDS` environment variable. Matched case-insensitively against the final command name. | Command names | Example: `qwen --disabled-slash-commands "auth,mcp,extensions"` |
|
|
601
|
+
| `--telemetry` | | Enables [telemetry](/developers/development/telemetry). | | |
|
|
602
|
+
| `--telemetry-target` | | Sets the telemetry target. | | See [telemetry](/developers/development/telemetry) for more information. |
|
|
603
|
+
| `--telemetry-otlp-endpoint` | | Sets the OTLP endpoint for telemetry. | | See [telemetry](../../developers/development/telemetry) for more information. |
|
|
604
|
+
| `--telemetry-otlp-protocol` | | Sets the OTLP protocol for telemetry (`grpc` or `http`). | | Defaults to `grpc`. See [telemetry](../../developers/development/telemetry) for more information. |
|
|
605
|
+
| `--telemetry-log-prompts` | | Enables logging of prompts for telemetry. | | See [telemetry](../../developers/development/telemetry) for more information. |
|
|
606
|
+
| `--checkpointing` | | Enables [checkpointing](../features/checkpointing). | | |
|
|
607
|
+
| `--acp` | | Enables ACP mode (Agent Client Protocol). Useful for IDE/editor integrations like [Zed](../integration-zed). | | Stable. Replaces the deprecated `--experimental-acp` flag. |
|
|
608
|
+
| `--experimental-lsp` | | Enables experimental [LSP (Language Server Protocol)](../features/lsp) feature for code intelligence (go-to-definition, find references, diagnostics, etc.). | | Experimental. Requires language servers to be installed. |
|
|
609
|
+
| `--extensions` | `-e` | Specifies a list of extensions to use for the session. | Extension names | If not provided, all available extensions are used. Use the special term `qwen -e none` to disable all extensions. Example: `qwen -e my-extension -e my-other-extension` |
|
|
610
|
+
| `--list-extensions` | `-l` | Lists all available extensions and exits. | | |
|
|
611
|
+
| `--proxy` | | Sets the proxy for the CLI. | Proxy URL | Example: `--proxy http://localhost:7890`. |
|
|
612
|
+
| `--include-directories` | | Includes additional directories in the workspace for multi-directory support. | Directory paths | Can be specified multiple times or as comma-separated values. 5 directories can be added at maximum. Example: `--include-directories /path/to/project1,/path/to/project2` or `--include-directories /path/to/project1 --include-directories /path/to/project2` |
|
|
613
|
+
| `--screen-reader` | | Enables screen reader mode, which adjusts the TUI for better compatibility with screen readers. | | |
|
|
614
|
+
| `--version` | | Displays the version of the CLI. | | |
|
|
615
|
+
| `--openai-logging` | | Enables logging of OpenAI API calls for debugging and analysis. | | This flag overrides the `enableOpenAILogging` setting in `settings.json`. |
|
|
616
|
+
| `--openai-logging-dir` | | Sets a custom directory path for OpenAI API logs. | Directory path | This flag overrides the `openAILoggingDir` setting in `settings.json`. Supports absolute paths, relative paths, and `~` expansion. Example: `qwen --openai-logging-dir "~/qwen-logs" --openai-logging` |
|
|
568
617
|
|
|
569
618
|
## Context Files (Hierarchical Instructional Context)
|
|
570
619
|
|