mirror of
https://github.com/QwenLM/qwen-code.git
synced 2026-04-28 11:41:04 +00:00
d9a1275913
Some checks are pending
Qwen Code CI / Lint (push) Waiting to run
Qwen Code CI / Test (push) Blocked by required conditions
Qwen Code CI / Test-1 (push) Blocked by required conditions
Qwen Code CI / Test-2 (push) Blocked by required conditions
Qwen Code CI / Test-3 (push) Blocked by required conditions
Qwen Code CI / Test-4 (push) Blocked by required conditions
Qwen Code CI / Test-5 (push) Blocked by required conditions
Qwen Code CI / Test-6 (push) Blocked by required conditions
Qwen Code CI / Test-7 (push) Blocked by required conditions
Qwen Code CI / Test-8 (push) Blocked by required conditions
Qwen Code CI / Post Coverage Comment (push) Blocked by required conditions
Qwen Code CI / CodeQL (push) Waiting to run
E2E Tests / E2E Test (Linux) - sandbox:docker (push) Waiting to run
E2E Tests / E2E Test (Linux) - sandbox:none (push) Waiting to run
E2E Tests / E2E Test - macOS (push) Waiting to run
fix(cli): disable follow-up suggestions by default
1487 lines
54 KiB
JSON
1487 lines
54 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"type": "object",
|
|
"description": "Qwen Code settings configuration",
|
|
"properties": {
|
|
"mcpServers": {
|
|
"description": "Configuration for MCP servers.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"channels": {
|
|
"description": "Configuration for messaging channels.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"modelProviders": {
|
|
"description": "Model providers configuration grouped by authType. Each authType contains an array of model configurations.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"codingPlan": {
|
|
"description": "Coding Plan template version tracking and configuration.",
|
|
"type": "object",
|
|
"properties": {
|
|
"version": {
|
|
"description": "SHA256 hash of the Coding Plan template. Used to detect template updates.",
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set as fallback defaults. These are loaded with the lowest priority: system environment variables > .env files > settings.json env field.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"general": {
|
|
"description": "General application settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"preferredEditor": {
|
|
"description": "The preferred editor to open files in.",
|
|
"type": "string"
|
|
},
|
|
"vimMode": {
|
|
"description": "Enable Vim keybindings",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"enableAutoUpdate": {
|
|
"description": "Enable automatic update checks and installations on startup.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"gitCoAuthor": {
|
|
"description": "Automatically add a Co-authored-by trailer to git commit messages when commits are made through Qwen Code.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"checkpointing": {
|
|
"description": "Session checkpointing settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"enabled": {
|
|
"description": "Enable session checkpointing for recovery",
|
|
"type": "boolean",
|
|
"default": false
|
|
}
|
|
}
|
|
},
|
|
"debugKeystrokeLogging": {
|
|
"description": "Enable debug logging of keystrokes to the console.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"language": {
|
|
"description": "The language for the user interface. Use \"auto\" to detect from system settings. You can also use custom language codes (e.g., \"es\", \"fr\") by placing JS language files in ~/.qwen/locales/ (e.g., ~/.qwen/locales/es.js). Options: auto, en, zh, ru, de, ja, pt",
|
|
"enum": [
|
|
"auto",
|
|
"en",
|
|
"zh",
|
|
"ru",
|
|
"de",
|
|
"ja",
|
|
"pt"
|
|
],
|
|
"default": "auto"
|
|
},
|
|
"outputLanguage": {
|
|
"description": "The language for LLM output. Use \"auto\" to detect from system settings, or set a specific language.",
|
|
"type": "string",
|
|
"default": "auto"
|
|
},
|
|
"terminalBell": {
|
|
"description": "Play terminal bell sound when response completes or needs approval.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"chatRecording": {
|
|
"description": "Enable saving chat history to disk. Disabling this will also prevent --continue and --resume from working.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"defaultFileEncoding": {
|
|
"description": "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. Options: utf-8, utf-8-bom",
|
|
"enum": [
|
|
"utf-8",
|
|
"utf-8-bom"
|
|
],
|
|
"default": "utf-8"
|
|
}
|
|
}
|
|
},
|
|
"output": {
|
|
"description": "Settings for the CLI output.",
|
|
"type": "object",
|
|
"properties": {
|
|
"format": {
|
|
"description": "The format of the CLI output. Options: text, json",
|
|
"enum": [
|
|
"text",
|
|
"json"
|
|
],
|
|
"default": "text"
|
|
}
|
|
}
|
|
},
|
|
"ui": {
|
|
"description": "User interface settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"theme": {
|
|
"description": "The color theme for the UI.",
|
|
"type": "string",
|
|
"default": "Qwen Dark"
|
|
},
|
|
"customThemes": {
|
|
"description": "Custom theme definitions.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"hideWindowTitle": {
|
|
"description": "Hide the window title bar",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"showStatusInTitle": {
|
|
"description": "Show Qwen Code status and thoughts in the terminal window title",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"hideTips": {
|
|
"description": "Hide helpful tips in the UI",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"showLineNumbers": {
|
|
"description": "Show line numbers in the code output.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"showCitations": {
|
|
"description": "Show citations for generated text in the chat.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"customWittyPhrases": {
|
|
"description": "Custom witty phrases to display during loading.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"enableWelcomeBack": {
|
|
"description": "Show welcome back dialog when returning to a project with conversation history.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"enableUserFeedback": {
|
|
"description": "Show optional feedback dialog after conversations to help improve Qwen performance.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"enableFollowupSuggestions": {
|
|
"description": "Show context-aware follow-up suggestions after task completion. Press Tab or Right Arrow to accept, Enter to accept and submit.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"enableCacheSharing": {
|
|
"description": "Use cache-aware forked queries for suggestion generation. Reduces cost on providers that support prefix caching (experimental).",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"enableSpeculation": {
|
|
"description": "Speculatively execute accepted suggestions before submission. Results appear instantly when you accept (experimental).",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"accessibility": {
|
|
"description": "Accessibility settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"enableLoadingPhrases": {
|
|
"description": "Enable loading phrases (disable for accessibility)",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"screenReader": {
|
|
"description": "Render output in plain-text to be more screen reader accessible",
|
|
"type": "boolean"
|
|
}
|
|
}
|
|
},
|
|
"feedbackLastShownTimestamp": {
|
|
"description": "The last time the feedback dialog was shown.",
|
|
"type": "number",
|
|
"default": 0
|
|
},
|
|
"verboseMode": {
|
|
"description": "Show full tool output and thinking in verbose mode (toggle with Ctrl+O).",
|
|
"type": "boolean",
|
|
"default": true
|
|
}
|
|
}
|
|
},
|
|
"ide": {
|
|
"description": "IDE integration settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"enabled": {
|
|
"description": "Enable IDE integration mode",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"hasSeenNudge": {
|
|
"description": "Whether the user has seen the IDE integration nudge.",
|
|
"type": "boolean",
|
|
"default": false
|
|
}
|
|
}
|
|
},
|
|
"privacy": {
|
|
"description": "Privacy-related settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"usageStatisticsEnabled": {
|
|
"description": "Enable collection of usage statistics",
|
|
"type": "boolean",
|
|
"default": true
|
|
}
|
|
}
|
|
},
|
|
"telemetry": {
|
|
"description": "Telemetry configuration.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"fastModel": {
|
|
"description": "Model for background tasks (suggestion generation, speculation). Leave empty to use the main model. A smaller/faster model (e.g., qwen3.5-flash) reduces latency and cost.",
|
|
"type": "string",
|
|
"default": ""
|
|
},
|
|
"model": {
|
|
"description": "Settings related to the generative model.",
|
|
"type": "object",
|
|
"properties": {
|
|
"name": {
|
|
"description": "The model to use for conversations.",
|
|
"type": "string"
|
|
},
|
|
"maxSessionTurns": {
|
|
"description": "Maximum number of user/model/tool turns to keep in a session. -1 means unlimited.",
|
|
"type": "number",
|
|
"default": -1
|
|
},
|
|
"chatCompression": {
|
|
"description": "Chat compression settings.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"sessionTokenLimit": {
|
|
"description": "The maximum number of tokens allowed in a session.",
|
|
"type": "number"
|
|
},
|
|
"skipNextSpeakerCheck": {
|
|
"description": "Skip the next speaker check.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"skipLoopDetection": {
|
|
"description": "Disable all loop detection checks (streaming and LLM).",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"skipStartupContext": {
|
|
"description": "Avoid sending the workspace startup context at the beginning of each session.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"enableOpenAILogging": {
|
|
"description": "Enable OpenAI logging.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"openAILoggingDir": {
|
|
"description": "Custom directory path for OpenAI API logs. If not specified, defaults to logs/openai in the current working directory.",
|
|
"type": "string"
|
|
},
|
|
"generationConfig": {
|
|
"description": "Generation configuration settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"timeout": {
|
|
"description": "Request timeout in milliseconds.",
|
|
"type": "number"
|
|
},
|
|
"maxRetries": {
|
|
"description": "Maximum number of retries for failed requests.",
|
|
"type": "number"
|
|
},
|
|
"enableCacheControl": {
|
|
"description": "Enable cache control for DashScope providers.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"schemaCompliance": {
|
|
"description": "The compliance mode for tool schemas sent to the model. Use \"openapi_30\" for strict OpenAPI 3.0 compatibility (e.g., for Gemini). Options: auto, openapi_30",
|
|
"enum": [
|
|
"auto",
|
|
"openapi_30"
|
|
],
|
|
"default": "auto"
|
|
},
|
|
"contextWindowSize": {
|
|
"description": "Overrides the default context window size for the selected model. Use this setting when a provider's effective context limit differs from Qwen Code's default. This value defines the model's assumed maximum context capacity, not a per-request token limit.",
|
|
"type": "number"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"context": {
|
|
"description": "Settings for managing context provided to the model.",
|
|
"type": "object",
|
|
"properties": {
|
|
"fileName": {
|
|
"description": "The name of the context file.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"importFormat": {
|
|
"description": "The format to use when importing memory.",
|
|
"type": "string"
|
|
},
|
|
"includeDirectories": {
|
|
"description": "Additional directories to include in the workspace context. Missing directories will be skipped with a warning.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"loadFromIncludeDirectories": {
|
|
"description": "Whether to load memory files from include directories.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"fileFiltering": {
|
|
"description": "Settings for git-aware file filtering.",
|
|
"type": "object",
|
|
"properties": {
|
|
"respectGitIgnore": {
|
|
"description": "Respect .gitignore files when searching",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"respectQwenIgnore": {
|
|
"description": "Respect .qwenignore files when searching",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"enableRecursiveFileSearch": {
|
|
"description": "Enable recursive file search functionality",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"enableFuzzySearch": {
|
|
"description": "Enable fuzzy search when searching for files.",
|
|
"type": "boolean",
|
|
"default": true
|
|
}
|
|
}
|
|
},
|
|
"gapThresholdMinutes": {
|
|
"description": "Minutes of inactivity after which retained thinking blocks are cleared to free context tokens. Aligns with provider prompt-cache TTL.",
|
|
"type": "number",
|
|
"default": 5
|
|
}
|
|
}
|
|
},
|
|
"permissions": {
|
|
"description": "Permission rules controlling tool usage. Rules are evaluated in priority order: deny > ask > allow.",
|
|
"type": "object",
|
|
"properties": {
|
|
"allow": {
|
|
"description": "Tools or commands that are auto-approved without confirmation. Examples: \"ShellTool\", \"Bash(git *)\", \"ReadFileTool\".",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"ask": {
|
|
"description": "Tools or commands that always require user confirmation. Takes precedence over allow rules.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"deny": {
|
|
"description": "Tools or commands that are always blocked. Highest priority rule. Examples: \"ShellTool\", \"Bash(rm -rf *)\".",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"tools": {
|
|
"description": "Settings for built-in and custom tools.",
|
|
"type": "object",
|
|
"properties": {
|
|
"sandbox": {
|
|
"description": "Sandbox execution environment (can be a boolean or a path string).",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"shell": {
|
|
"description": "Settings for shell execution.",
|
|
"type": "object",
|
|
"properties": {
|
|
"enableInteractiveShell": {
|
|
"description": "Use node-pty for an interactive shell experience. Falls back to child_process if PTY is unavailable.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"pager": {
|
|
"description": "The pager command to use for shell output. Defaults to `cat`.",
|
|
"type": "string",
|
|
"default": "cat"
|
|
},
|
|
"showColor": {
|
|
"description": "Show color in shell output.",
|
|
"type": "boolean",
|
|
"default": false
|
|
}
|
|
}
|
|
},
|
|
"core": {
|
|
"description": "Deprecated. Use permissions.allow instead.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"allowed": {
|
|
"description": "Deprecated. Use permissions.allow instead.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"exclude": {
|
|
"description": "Deprecated. Use permissions.deny instead.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"approvalMode": {
|
|
"description": "Approval mode for tool usage. Controls how tools are approved before execution. Options: plan, default, auto-edit, yolo",
|
|
"enum": [
|
|
"plan",
|
|
"default",
|
|
"auto-edit",
|
|
"yolo"
|
|
],
|
|
"default": "default"
|
|
},
|
|
"autoAccept": {
|
|
"description": "Automatically accept and execute tool calls that are considered safe (e.g., read-only operations) without explicit user confirmation.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"discoveryCommand": {
|
|
"description": "Command to run for tool discovery.",
|
|
"type": "string"
|
|
},
|
|
"callCommand": {
|
|
"description": "Command to run for tool calls.",
|
|
"type": "string"
|
|
},
|
|
"useRipgrep": {
|
|
"description": "Use ripgrep for file content search instead of the fallback implementation. Provides faster search performance.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"useBuiltinRipgrep": {
|
|
"description": "Use the bundled ripgrep binary. When set to false, the system-level \"rg\" command will be used instead. This setting is only effective when useRipgrep is true.",
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"truncateToolOutputThreshold": {
|
|
"description": "Truncate tool output if it is larger than this many characters. Set to -1 to disable.",
|
|
"type": "number",
|
|
"default": 25000
|
|
},
|
|
"truncateToolOutputLines": {
|
|
"description": "The number of lines to keep when truncating tool output.",
|
|
"type": "number",
|
|
"default": 1000
|
|
}
|
|
}
|
|
},
|
|
"mcp": {
|
|
"description": "Settings for Model Context Protocol (MCP) servers.",
|
|
"type": "object",
|
|
"properties": {
|
|
"serverCommand": {
|
|
"description": "Command to start an MCP server.",
|
|
"type": "string"
|
|
},
|
|
"allowed": {
|
|
"description": "A list of MCP servers to allow.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"excluded": {
|
|
"description": "A list of MCP servers to exclude.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"security": {
|
|
"description": "Security-related settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"folderTrust": {
|
|
"description": "Settings for folder trust.",
|
|
"type": "object",
|
|
"properties": {
|
|
"enabled": {
|
|
"description": "Setting to track whether Folder trust is enabled.",
|
|
"type": "boolean",
|
|
"default": false
|
|
}
|
|
}
|
|
},
|
|
"auth": {
|
|
"description": "Authentication settings.",
|
|
"type": "object",
|
|
"properties": {
|
|
"selectedType": {
|
|
"description": "The currently selected authentication type.",
|
|
"type": "string"
|
|
},
|
|
"enforcedType": {
|
|
"description": "The required auth type. If this does not match the selected auth type, the user will be prompted to re-authenticate.",
|
|
"type": "string"
|
|
},
|
|
"useExternal": {
|
|
"description": "Whether to use an external authentication flow.",
|
|
"type": "boolean"
|
|
},
|
|
"apiKey": {
|
|
"description": "API key for OpenAI compatible authentication.",
|
|
"type": "string"
|
|
},
|
|
"baseUrl": {
|
|
"description": "Base URL for OpenAI compatible API.",
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"advanced": {
|
|
"description": "Advanced settings for power users.",
|
|
"type": "object",
|
|
"properties": {
|
|
"autoConfigureMemory": {
|
|
"description": "Automatically configure Node.js memory limits",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"dnsResolutionOrder": {
|
|
"description": "The DNS resolution order.",
|
|
"type": "string"
|
|
},
|
|
"excludedEnvVars": {
|
|
"description": "Environment variables to exclude from project context.",
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"default": [
|
|
"DEBUG",
|
|
"DEBUG_MODE"
|
|
]
|
|
},
|
|
"bugCommand": {
|
|
"description": "Configuration for the bug report command.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"runtimeOutputDir": {
|
|
"description": "Custom directory for runtime output (temp files, debug logs, session data, todos, etc.). Config files remain at ~/.qwen. Env var QWEN_RUNTIME_DIR takes priority.",
|
|
"type": "string"
|
|
},
|
|
"tavilyApiKey": {
|
|
"description": "⚠️ DEPRECATED: Please use webSearch.provider configuration instead. Legacy API key for the Tavily API.",
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"webSearch": {
|
|
"description": "Configuration for web search providers.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"agents": {
|
|
"description": "Settings for multi-agent collaboration features (Arena, Team, Swarm).",
|
|
"type": "object",
|
|
"properties": {
|
|
"displayMode": {
|
|
"description": "Display mode for multi-agent sessions. Currently only \"in-process\" is supported. Options: in-process",
|
|
"enum": [
|
|
"in-process"
|
|
]
|
|
},
|
|
"arena": {
|
|
"description": "Settings for Arena (multi-model competitive execution).",
|
|
"type": "object",
|
|
"properties": {
|
|
"worktreeBaseDir": {
|
|
"description": "Custom base directory for Arena worktrees. Defaults to ~/.qwen/arena.",
|
|
"type": "string"
|
|
},
|
|
"preserveArtifacts": {
|
|
"description": "When enabled, Arena worktrees and session state files are preserved after the session ends or the main agent exits.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"maxRoundsPerAgent": {
|
|
"description": "Maximum number of rounds (turns) each agent can execute. No limit if unset.",
|
|
"type": "number"
|
|
},
|
|
"timeoutSeconds": {
|
|
"description": "Total timeout in seconds for the Arena session. No limit if unset.",
|
|
"type": "number"
|
|
}
|
|
}
|
|
},
|
|
"team": {
|
|
"description": "Settings for Agent Team (role-based collaborative execution). Reserved for future use.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
},
|
|
"swarm": {
|
|
"description": "Settings for Agent Swarm (parallel sub-agent execution). Reserved for future use.",
|
|
"type": "object",
|
|
"additionalProperties": true
|
|
}
|
|
}
|
|
},
|
|
"disableAllHooks": {
|
|
"description": "Temporarily disable all hooks without deleting configurations. Default is false (hooks enabled).",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"hooks": {
|
|
"description": "Hook event configurations for extending CLI behavior at various lifecycle points.",
|
|
"type": "object",
|
|
"properties": {
|
|
"UserPromptSubmit": {
|
|
"description": "Hooks that execute before agent processing. Can modify prompts or inject context.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"Stop": {
|
|
"description": "Hooks that execute after agent processing. Can post-process responses or log interactions.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"Notification": {
|
|
"description": "Hooks that execute when notifications are sent.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"PreToolUse": {
|
|
"description": "Hooks that execute before tool execution.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"PostToolUse": {
|
|
"description": "Hooks that execute after successful tool execution.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"PostToolUseFailure": {
|
|
"description": "Hooks that execute when tool execution fails. ",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"SessionStart": {
|
|
"description": "Hooks that execute when a new session starts or resumes.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"SessionEnd": {
|
|
"description": "Hooks that execute when a session ends.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"PreCompact": {
|
|
"description": "Hooks that execute before conversation compaction.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"SubagentStart": {
|
|
"description": "Hooks that execute when a subagent (Task tool call) is started.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"SubagentStop": {
|
|
"description": "Hooks that execute right before a subagent (Task tool call) concludes its response.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
},
|
|
"PermissionRequest": {
|
|
"description": "Hooks that execute when a permission dialog is displayed.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook definition with an optional matcher and a list of hook configurations.",
|
|
"type": "object",
|
|
"properties": {
|
|
"matcher": {
|
|
"description": "An optional matcher pattern to filter when this hook definition applies.",
|
|
"type": "string"
|
|
},
|
|
"sequential": {
|
|
"description": "Whether the hooks should be executed sequentially instead of in parallel.",
|
|
"type": "boolean"
|
|
},
|
|
"hooks": {
|
|
"description": "The list of hook configurations to execute.",
|
|
"type": "array",
|
|
"items": {
|
|
"description": "A hook configuration entry that defines a command to execute.",
|
|
"type": "object",
|
|
"properties": {
|
|
"type": {
|
|
"description": "The type of hook.",
|
|
"type": "string",
|
|
"enum": [
|
|
"command"
|
|
]
|
|
},
|
|
"command": {
|
|
"description": "The command to execute when the hook is triggered.",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"description": "An optional name for the hook.",
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"description": "An optional description of what the hook does.",
|
|
"type": "string"
|
|
},
|
|
"timeout": {
|
|
"description": "Timeout in milliseconds for the hook execution.",
|
|
"type": "number"
|
|
},
|
|
"env": {
|
|
"description": "Environment variables to set when executing the hook command.",
|
|
"type": "object",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"type",
|
|
"command"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"hooks"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"experimental": {
|
|
"description": "Settings to enable experimental features.",
|
|
"type": "object",
|
|
"properties": {
|
|
"cron": {
|
|
"description": "Enable in-session cron/loop tools (experimental). When enabled, the model can create recurring prompts using cron_create, cron_list, and cron_delete tools. Can also be enabled via QWEN_CODE_ENABLE_CRON=1 environment variable.",
|
|
"type": "boolean",
|
|
"default": false
|
|
}
|
|
}
|
|
},
|
|
"$version": {
|
|
"type": "number",
|
|
"description": "Settings schema version for migration tracking.",
|
|
"default": 3
|
|
}
|
|
},
|
|
"additionalProperties": true
|
|
}
|