diff --git a/docs/users/configuration/settings.md b/docs/users/configuration/settings.md index 2f1f2a16a61..0591a099d99 100644 --- a/docs/users/configuration/settings.md +++ b/docs/users/configuration/settings.md @@ -264,6 +264,18 @@ The `extra_body` field allows you to add custom parameters to the request body s | ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | `visionModel` | string | Image-capable model used as the vision bridge: when a text-only main model receives an image, or `read_file` needs the bounded PDF visual fallback, it is transcribed by this model first. Setting this explicitly authorizes bridge calls to that model even when it uses another provider; the tool display discloses the endpoint. Leave empty to auto-pick a same-provider vision model. Can also be set via `/model --vision`. | `""` | +#### compactionModel + +| Setting | Type | Description | Default | +| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | +| `compactionModel` | string | Model used for chat compression (auto-compaction). Leave empty to fall back to the main model. A smaller or faster model can reduce compression latency and cost. Can also be set or cleared via `/model --compaction`. | `""` | + +#### imageModel + +| Setting | Type | Description | Default | +| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | +| `imageModel` | string | Model used by the built-in `image_gen` tool. The selected model must have `imageOnly: true`, an HTTPS `baseUrl`, and `envKey` in `modelProviders`. Leave empty to keep the tool unavailable. Can also be set via `/model --image`. | `""` | + #### visionBridgeTimeoutMs | Setting | Type | Description | Default | diff --git a/docs/users/features/commands.md b/docs/users/features/commands.md index 6ac20b12a16..e76a9203d33 100644 --- a/docs/users/features/commands.md +++ b/docs/users/features/commands.md @@ -77,45 +77,47 @@ 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`, `/mcp nodesc`, `/mcp schema` | -| `/import-config` | Import MCP servers from Claude configs | `/import-config all`, `/import-config claude-code`, `/import-config claude-desktop --scope user\|project` | -| `/tools` | Display currently available tool list | `/tools`, `/tools desc` | -| `/skills` | Open the Skills panel to browse, search, toggle, and launch skills | `/skills`, `/` | -| `/learn` | Create a reusable project skill from a file, directory, URL, video, or text | `/learn https://docs.example.com/api`, `/learn ./tutorial.mp4 focus on deployment` | -| `/curator` | Inspect, pin, archive, or restore inactive project auto-skills | `/curator`, `/curator run --dry-run`, `/curator pin `, `/curator restore ` | -| `/plan` | Switch to plan mode or exit plan mode | `/plan`, `/plan `, `/plan exit` | -| `/approval-mode` | Change the tool-approval mode (current session only) | `/approval-mode`, `/approval-mode auto-edit` | -| → `plan` | Analysis only, no execution (secure review) | `/approval-mode plan` | -| → `default` | Require approval for edits (daily use) | `/approval-mode default` | -| → `auto-edit` | Auto-approve edits (trusted environment) | `/approval-mode auto-edit` | -| → `auto` | Classifier-evaluated approval (autonomous) | `/approval-mode auto` | -| → `yolo` | Auto-approve everything (quick prototyping) | `/approval-mode yolo` | -| `/model` | Switch model used in current session | `/model`, `/model ` (switch immediately) | -| `/model --fast` | Set a lighter model for prompt suggestions | `/model --fast qwen3-coder-flash` | -| `/model --voice` | Set the model used for voice transcription | `/model --voice ` | -| `/model --vision` | Set the vision-bridge model used to transcribe images for a text-only main model | `/model --vision ` | -| `/effort` | Set reasoning effort for thinking-capable models | `/effort` (opens picker), `/effort high` (low/medium/high/xhigh/max; mapped & clamped per provider) | -| `/extensions` | Manage extensions | `/extensions list`, `/extensions manage` | -| → `list` | List installed extensions | `/extensions list` | -| → `manage` | Manage installed extensions (interactive) | `/extensions manage` | -| → `explore` | Open extensions page in browser | `/extensions explore ` | -| → `install` | Install an extension from a git repo or path | `/extensions install ` | -| `/memory` | Open the Memory Manager dialog | `/memory` | -| `/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` | -| `/reload-plugins` | Reload extension changes (commands, skills, agents, hooks, MCP/LSP servers) from disk | `/reload-plugins` | -| `/permissions` | Manage permission rules | `/permissions` | -| `/agents` | Manage subagents | `/agents manage`, `/agents create` | -| `/arena` | Manage Arena sessions | `/arena start`, `/arena stop`, `/arena status`, `/arena select` (alias `choose`) | -| `/goal` | Set a goal — keep working until condition met | `/goal `, `/goal clear` | -| `/tasks` | List background tasks | `/tasks` | -| `/workflows` | Inspect workflow runs | `/workflows`, `/workflows ` | -| `/lsp` | Show LSP server status | `/lsp` | -| `/trust` | Manage folder trust settings | `/trust` | +| Command | Description | Usage Examples | +| --------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | +| `/mcp` | List configured MCP servers and tools | `/mcp`, `/mcp desc`, `/mcp nodesc`, `/mcp schema` | +| `/import-config` | Import MCP servers from Claude configs | `/import-config all`, `/import-config claude-code`, `/import-config claude-desktop --scope user\|project` | +| `/tools` | Display currently available tool list | `/tools`, `/tools desc` | +| `/skills` | Open the Skills panel to browse, search, toggle, and launch skills | `/skills`, `/` | +| `/learn` | Create a reusable project skill from a file, directory, URL, video, or text | `/learn https://docs.example.com/api`, `/learn ./tutorial.mp4 focus on deployment` | +| `/curator` | Inspect, pin, archive, or restore inactive project auto-skills | `/curator`, `/curator run --dry-run`, `/curator pin `, `/curator restore ` | +| `/plan` | Switch to plan mode or exit plan mode | `/plan`, `/plan `, `/plan exit` | +| `/approval-mode` | Change the tool-approval mode (current session only) | `/approval-mode`, `/approval-mode auto-edit` | +| → `plan` | Analysis only, no execution (secure review) | `/approval-mode plan` | +| → `default` | Require approval for edits (daily use) | `/approval-mode default` | +| → `auto-edit` | Auto-approve edits (trusted environment) | `/approval-mode auto-edit` | +| → `auto` | Classifier-evaluated approval (autonomous) | `/approval-mode auto` | +| → `yolo` | Auto-approve everything (quick prototyping) | `/approval-mode yolo` | +| `/model` | Switch model used in current session | `/model`, `/model ` (switch immediately) | +| `/model --fast` | Set a lighter model for prompt suggestions | `/model --fast qwen3-coder-flash` | +| `/model --voice` | Set the model used for voice transcription | `/model --voice ` | +| `/model --vision` | Set the vision-bridge model used to transcribe images for a text-only main model | `/model --vision ` | +| `/model --compaction` | Set the model used for chat compression | `/model --compaction `, `/model --compaction clear` | +| `/model --image` | Set an image-only model for the built-in image generation tool | `/model --image ` | +| `/effort` | Set reasoning effort for thinking-capable models | `/effort` (opens picker), `/effort high` (low/medium/high/xhigh/max; mapped & clamped per provider) | +| `/extensions` | Manage extensions | `/extensions list`, `/extensions manage` | +| → `list` | List installed extensions | `/extensions list` | +| → `manage` | Manage installed extensions (interactive) | `/extensions manage` | +| → `explore` | Open extensions page in browser | `/extensions explore ` | +| → `install` | Install an extension from a git repo or path | `/extensions install ` | +| `/memory` | Open the Memory Manager dialog | `/memory` | +| `/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` | +| `/reload-plugins` | Reload extension changes (commands, skills, agents, hooks, MCP/LSP servers) from disk | `/reload-plugins` | +| `/permissions` | Manage permission rules | `/permissions` | +| `/agents` | Manage subagents | `/agents manage`, `/agents create` | +| `/arena` | Manage Arena sessions | `/arena start`, `/arena stop`, `/arena status`, `/arena select` (alias `choose`) | +| `/goal` | Set a goal — keep working until condition met | `/goal `, `/goal clear` | +| `/tasks` | List background tasks | `/tasks` | +| `/workflows` | Inspect workflow runs | `/workflows`, `/workflows ` | +| `/lsp` | Show LSP server status | `/lsp` | +| `/trust` | Manage folder trust settings | `/trust` | > [!warning] >