diff --git a/docs/users/configuration/settings.md b/docs/users/configuration/settings.md index 26d2acdc910..cb7a4892fb3 100644 --- a/docs/users/configuration/settings.md +++ b/docs/users/configuration/settings.md @@ -108,18 +108,16 @@ Settings are organized into categories. Most settings should be placed within th | `ui.customBannerTitle` | string | Replace the default `>_ Qwen Code` title in the banner info panel. The `(vX.Y.Z)` version suffix is always appended; auth, model, and path lines are not affected. Sanitized; capped at 80 characters. | `""` | | `ui.customBannerSubtitle` | string | Optional subtitle line rendered between the banner title and the auth/model line, in place of the blank spacer row. Sanitized; capped at 160 characters. Empty (default) keeps the original blank spacer. | `""` | | `ui.customAsciiArt` | string \| object | Replace the QWEN ASCII logo in the banner. Accepts an inline string (used for both width tiers), `{ "path": "./brand.txt" }` (relative paths resolve against the owning settings file's directory; read once at startup with `O_NOFOLLOW` on POSIX, capped at 64 KB), or `{ "small": ..., "large": ... }` for width-aware selection. Sanitized; capped at 200 lines × 200 columns per tier. | `undefined` | -| `ui.hideFooter` | boolean | Hide the footer from the UI. | `false` | -| `ui.showMemoryUsage` | boolean | Display memory usage information in the UI. | `false` | | `ui.showLineNumbers` | boolean | Show line numbers in code blocks in the CLI output. | `true` | | `ui.renderMode` | string | Default Markdown display mode. Use `"render"` for rich visual previews or `"raw"` to show source-oriented Markdown by default. Toggle during a session with `Alt/Option+M`; on macOS the terminal must send Option as Meta. See [Markdown Rendering](../features/markdown-rendering). | `"render"` | -| `ui.showCitations` | boolean | Show citations for generated text in the chat. | `true` | +| `ui.showCitations` | boolean | Show citations for generated text in the chat. | `false` | | `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` | | `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` | -| `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` | +| `ui.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` | | `ui.accessibility.enableLoadingPhrases` | boolean | Enable loading phrases (disable for accessibility). | `true` | | `ui.accessibility.screenReader` | boolean | Enables screen reader mode, which adjusts the TUI for better compatibility with screen readers. | `false` | | `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. | `[]` | -| `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` | +| `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. | `false` | | `ui.enableCacheSharing` | boolean | Use cache-aware forked queries for suggestion generation. Reduces cost on providers that support prefix caching (experimental). | `true` | | `ui.enableSpeculation` | boolean | Speculatively execute accepted suggestions before submission. Results appear instantly when you accept (experimental). | `false` | | `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` | diff --git a/docs/users/features/approval-mode.md b/docs/users/features/approval-mode.md index cdb123f47f4..a26566966fb 100644 --- a/docs/users/features/approval-mode.md +++ b/docs/users/features/approval-mode.md @@ -94,8 +94,8 @@ How should we handle database migration? ```json // .qwen/settings.json { - "permissions": { - "defaultMode": "plan" + "tools": { + "approvalMode": "plan" } } ``` @@ -157,8 +157,8 @@ You can review each proposed change and approve or reject it individually. ```bash // .qwen/settings.json { - "permissions": { -"defaultMode": "default" + "tools": { + "approvalMode": "default" } } ``` @@ -340,10 +340,8 @@ YOLO Mode grants Qwen Code the highest permissions, automatically approving all ```bash // .qwen/settings.json { - "permissions": { -"defaultMode": "yolo", -"confirmShellCommands": false, -"confirmFileEdits": false + "tools": { + "approvalMode": "yolo" } } ``` @@ -364,10 +362,10 @@ 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 four modes: +During a Qwen Code session, use **Shift+Tab**​ (or **Tab** on Windows) to quickly cycle through the five modes: ``` -Ask Permissions Mode → Auto-Edit Mode → YOLO Mode → Plan Mode → Ask Permissions Mode +Plan Mode → Ask Permissions Mode → Auto-Edit Mode → Auto Mode → YOLO Mode → Plan Mode ``` ### Persistent Configuration @@ -376,10 +374,8 @@ Ask Permissions Mode → Auto-Edit Mode → YOLO Mode → Plan Mode → Ask Perm // Project-level: ./.qwen/settings.json // User-level: ~/.qwen/settings.json { - "permissions": { -"defaultMode": "auto-edit", // or "plan" or "yolo" -"confirmShellCommands": true, -"confirmFileEdits": true + "tools": { + "approvalMode": "auto-edit" // or "plan", "default", "auto", "yolo" } } ``` diff --git a/docs/users/features/commands.md b/docs/users/features/commands.md index d8e6e20d2fe..a67d0609328 100644 --- a/docs/users/features/commands.md +++ b/docs/users/features/commands.md @@ -18,15 +18,21 @@ Slash commands are used to manage Qwen Code sessions, interface, and basic behav These commands help you save, restore, and summarize work progress. -| Command | Description | Usage Examples | -| ---------------- | ------------------------------------------------------------------------ | ------------------------------------ | -| `/init` | Analyze current directory and create initial context file | `/init` | -| `/summary` | Generate project summary based on conversation history | `/summary` | -| `/compress` | Replace chat history with summary to save Tokens | `/compress` | -| `/compress-fast` | Fast compression without AI — strips old tool outputs and thinking parts | `/compress-fast` | -| `/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 ` | +| Command | Description | Usage Examples | +| ---------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------- | +| `/init` | Analyze current directory and create initial context file | `/init` | +| `/summary` | Generate project summary based on conversation history | `/summary` | +| `/compress` | Replace chat history with summary to save Tokens | `/compress` | +| `/compress-fast` | Fast compression without AI — strips old tool outputs and thinking parts | `/compress-fast` | +| `/resume` | Resume a previous conversation session | `/resume` | +| `/recap` | Generate a one-line session recap now | `/recap` | +| `/restore` | Revert project files to the checkpoint before a tool call ran | `/restore` (list) or `/restore ` | +| `/delete` | Delete a previous session | `/delete` | +| `/branch` | Fork the current conversation into a new session | `/branch` | +| `/fork` | Spawn a background agent that inherits the full conversation | `/fork ` | +| `/rewind` | Rewind conversation to a previous turn | `/rewind` or `/rollback` | +| `/export` | Export session history to file | `/export html`, `/export md`, `/export json`, `/export jsonl` | +| `/rename` | Rename or tag the current session | `/rename My Feature` or `/tag` | ### 1.2 Interface and Workspace Control @@ -44,6 +50,7 @@ Commands for adjusting interface appearance and work environment. | `/editor` | Open dialog to select supported editor | `/editor` | | `/statusline` | Open interactive [status line](./status-line.md) preset dialog | `/statusline` | | `/statusline ` | Generate a command-mode [status line](./status-line.md) via agent | `/statusline show model and git branch` | +| `/terminal-setup` | Configure terminal keybindings for multiline input | `/terminal-setup` | ### 1.3 Language Settings @@ -72,6 +79,7 @@ Commands for managing AI tools and models. | →`plan` | Analysis only, no execution | Secure review | | →`default` | Require approval for edits | Daily use | | →`auto-edit` | Automatically approve edits | Trusted environment | +| →`auto` | Classifier-evaluated approval | Autonomous sessions with safety guardrails | | →`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` | @@ -80,6 +88,14 @@ Commands for managing AI tools and models. | `/remember` | Save a durable memory | `/remember Prefer terse responses` | | `/forget` | Remove matching entries from auto-memory | `/forget ` | | `/dream` | Manually run auto-memory consolidation | `/dream` | +| `/hooks` | Manage Qwen Code hooks | `/hooks`, `/hooks list` | +| `/permissions` | Manage permission rules | `/permissions` | +| `/agents` | Manage subagents | `/agents manage`, `/agents create` | +| `/arena` | Manage Arena sessions | `/arena start`, `/arena status` | +| `/goal` | Set a goal — keep working until condition met | `/goal `, `/goal clear` | +| `/tasks` | List background tasks | `/tasks` | +| `/lsp` | Show LSP server status | `/lsp` | +| `/trust` | Manage folder trust settings | `/trust` | ### 1.5 Built-in Skills @@ -193,7 +209,7 @@ 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 +(default: `false`); the manual `/recap` command always works regardless of this setting. **Example:** @@ -210,8 +226,8 @@ this setting. > > Configure a fast model via `/model --fast ` (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. +> `general.showSessionRecap` to `true` to enable the auto-trigger; the +> manual `/recap` command always works regardless of this setting. ### 1.8 Diff Viewer (`/diff`) @@ -279,6 +295,11 @@ Commands for obtaining information and performing system settings. | `/stats tools` | Show per-tool call counts | `/stats tools` | | `/settings` | Open settings editor | `/settings` | | `/auth` | Change authentication method | `/auth` | +| `/doctor` | Run installation and environment diagnostics | `/doctor`, `/doctor memory` | +| `/docs` | Open full Qwen Code documentation in browser | `/docs` | +| `/ide` | Manage IDE integration | `/ide status`, `/ide install` | +| `/insight` | Generate programming insights from chat history | `/insight` | +| `/setup-github` | Set up GitHub Actions | `/setup-github` | | `/bug` | Submit issue about Qwen Code | `/bug Button click unresponsive` | | `/copy` | Copy AI output to clipboard (`/copy N` = Nth-last AI message) | `/copy` or `/copy 2` | | `/quit` | Exit Qwen Code immediately | `/quit` or `/exit` | diff --git a/docs/users/features/followup-suggestions.md b/docs/users/features/followup-suggestions.md index b4eb19fabf3..aaaf463b43d 100644 --- a/docs/users/features/followup-suggestions.md +++ b/docs/users/features/followup-suggestions.md @@ -32,7 +32,7 @@ Suggestions are generated when all of the following conditions are met: - There are no errors in the most recent response - No confirmation dialogs are pending (e.g., shell confirmation, permissions) - The approval mode is not set to `plan` -- The feature is enabled in settings (enabled by default) +- The feature is enabled in settings (disabled by default — set `ui.enableFollowupSuggestions` to `true` to turn it on) Suggestions will not appear in non-interactive mode (e.g., headless/SDK mode). @@ -72,7 +72,7 @@ These settings can be configured in `settings.json`: | Setting | Type | Default | Description | | ------------------------------ | ------- | ------- | ------------------------------------------------------------------ | -| `ui.enableFollowupSuggestions` | boolean | `true` | Enable or disable followup suggestions | +| `ui.enableFollowupSuggestions` | boolean | `false` | Enable or disable followup suggestions | | `ui.enableCacheSharing` | boolean | `true` | Use cache-aware forked queries to reduce cost (experimental) | | `ui.enableSpeculation` | boolean | `false` | Speculatively execute suggestions before submission (experimental) | | `fastModel` | string | `""` | Model for prompt suggestions and speculative execution |