diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index c410b6cdd..3608d961b 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -83,6 +83,23 @@ jobs:
       - name: 'Run sensitive keyword linter'
         run: 'node scripts/lint.js --sensitive-keywords'
 
+      - name: 'Build CLI package'
+        run: 'npm run build --workspace=packages/cli'
+
+      - name: 'Generate settings schema'
+        run: 'npm run generate:settings-schema'
+
+      - name: 'Check settings schema is up-to-date'
+        run: |
+          if [[ -n $(git status --porcelain packages/vscode-ide-companion/schemas/settings.schema.json) ]]; then
+            echo "❌ Error: settings.schema.json is out of date!"
+            echo "   Please run: npm run generate:settings-schema"
+            echo "   Then commit the updated schema file."
+            git diff packages/vscode-ide-companion/schemas/settings.schema.json
+            exit 1
+          fi
+          echo "✅ Settings schema is up-to-date"
+
   #
   # Test: Node
   #
diff --git a/.prettierignore b/.prettierignore
index c9ae7e56a..5e9d79005 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -18,4 +18,5 @@ eslint.config.js
 gha-creds-*.json
 junit.xml
 Thumbs.db
+packages/vscode-ide-companion/schemas/settings.schema.json
 packages/cli/src/services/insight/templates/insightTemplate.ts
diff --git a/package.json b/package.json
index e7caedb81..ef9f25eff 100644
--- a/package.json
+++ b/package.json
@@ -20,6 +20,7 @@
     "dev": "node scripts/dev.js",
     "debug": "cross-env DEBUG=1 node --inspect-brk scripts/start.js",
     "generate": "node scripts/generate-git-commit-info.js",
+    "generate:settings-schema": "tsx scripts/generate-settings-schema.ts",
     "build": "node scripts/build.js",
     "build-and-start": "npm run build && npm run start",
     "build:vscode": "node scripts/build_vscode_companion.js",
diff --git a/packages/vscode-ide-companion/.vscodeignore b/packages/vscode-ide-companion/.vscodeignore
index 18e07a04b..5d1a75d88 100644
--- a/packages/vscode-ide-companion/.vscodeignore
+++ b/packages/vscode-ide-companion/.vscodeignore
@@ -6,3 +6,5 @@
 !LICENSE
 !NOTICES.txt
 !assets/
+!schemas/
+!schemas/**
diff --git a/packages/vscode-ide-companion/package.json b/packages/vscode-ide-companion/package.json
index 0f55c1248..f83d3cd86 100644
--- a/packages/vscode-ide-companion/package.json
+++ b/packages/vscode-ide-companion/package.json
@@ -31,6 +31,12 @@
     "onStartupFinished"
   ],
   "contributes": {
+    "jsonValidation": [
+      {
+        "fileMatch": "**/.qwen/settings.json",
+        "url": "./schemas/settings.schema.json"
+      }
+    ],
     "languages": [
       {
         "id": "qwen-diff-editable"
diff --git a/packages/vscode-ide-companion/schemas/settings.schema.json b/packages/vscode-ide-companion/schemas/settings.schema.json
new file mode 100644
index 000000000..8b5fca2b0
--- /dev/null
+++ b/packages/vscode-ide-companion/schemas/settings.schema.json
@@ -0,0 +1,599 @@
+{
+  "$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
+    },
+    "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.env.",
+      "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": false
+        },
+        "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
+        },
+        "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
+        }
+      }
+    },
+    "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
+    },
+    "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
+        },
+        "summarizeToolOutput": {
+          "description": "Settings for summarizing tool output.",
+          "type": "object",
+          "additionalProperties": true
+        },
+        "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": false
+        },
+        "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
+            }
+          }
+        }
+      }
+    },
+    "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. Fallback to child_process still applies.",
+              "type": "boolean",
+              "default": false
+            },
+            "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": "Paths to core tool definitions.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "allowed": {
+          "description": "A list of tool names that will bypass the confirmation dialog.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "exclude": {
+          "description": "Tool names to exclude from discovery.",
+          "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
+        },
+        "enableToolOutputTruncation": {
+          "description": "Enable truncation of large tool outputs.",
+          "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
+        },
+        "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
+    },
+    "experimental": {
+      "description": "Setting to enable experimental features",
+      "type": "object",
+      "properties": {
+        "visionModelPreview": {
+          "description": "Enable vision model support and auto-switching functionality. When disabled, vision models like qwen-vl-max-latest will be hidden and auto-switching will not occur.",
+          "type": "boolean",
+          "default": true
+        },
+        "vlmSwitchMode": {
+          "description": "Default behavior when images are detected in input. Values: once (one-time switch), session (switch for entire session), persist (continue with current model). If not set, user will be prompted each time. This is a temporary experimental feature.",
+          "type": "string"
+        }
+      }
+    },
+    "$version": {
+      "type": "number",
+      "description": "Settings schema version for migration tracking.",
+      "default": 3
+    }
+  },
+  "additionalProperties": true
+}
diff --git a/scripts/build.js b/scripts/build.js
index 68da1c6e8..0ce010b3b 100644
--- a/scripts/build.js
+++ b/scripts/build.js
@@ -56,6 +56,15 @@ for (const workspace of buildOrder) {
     stdio: 'inherit',
     cwd: root,
   });
+
+  // After cli is built, generate the JSON Schema for settings
+  // so the vscode-ide-companion extension can provide IntelliSense
+  if (workspace === 'packages/cli') {
+    execSync('npx tsx scripts/generate-settings-schema.ts', {
+      stdio: 'inherit',
+      cwd: root,
+    });
+  }
 }
 
 // also build container image if sandboxing is enabled
diff --git a/scripts/generate-settings-schema.ts b/scripts/generate-settings-schema.ts
new file mode 100644
index 000000000..9d13e8166
--- /dev/null
+++ b/scripts/generate-settings-schema.ts
@@ -0,0 +1,146 @@
+/**
+ * @license
+ * Copyright 2025 Qwen team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Generates a JSON Schema from the internal SETTINGS_SCHEMA definition.
+ *
+ * Usage: npx tsx scripts/generate-settings-schema.ts
+ *
+ * This reads the TypeScript settings schema and converts it to a standard
+ * JSON Schema file that VS Code uses for IntelliSense in settings.json files.
+ *
+ * Prerequisites: npm run build (core package must be built first)
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import type {
+  SettingDefinition,
+  SettingsSchema,
+} from '../packages/cli/src/config/settingsSchema.js';
+import { getSettingsSchema } from '../packages/cli/src/config/settingsSchema.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+interface JsonSchemaProperty {
+  $schema?: string;
+  type?: string | string[];
+  description?: string;
+  properties?: Record<string, JsonSchemaProperty>;
+  items?: JsonSchemaProperty;
+  enum?: (string | number)[];
+  default?: unknown;
+  additionalProperties?: boolean | JsonSchemaProperty;
+}
+
+function convertSettingToJsonSchema(
+  setting: SettingDefinition,
+): JsonSchemaProperty {
+  const schema: JsonSchemaProperty = {};
+
+  if (setting.description) {
+    schema.description = setting.description;
+  }
+
+  switch (setting.type) {
+    case 'boolean':
+      schema.type = 'boolean';
+      break;
+    case 'string':
+      schema.type = 'string';
+      break;
+    case 'number':
+      schema.type = 'number';
+      break;
+    case 'array':
+      schema.type = 'array';
+      schema.items = { type: 'string' };
+      break;
+    case 'enum':
+      if (setting.options && setting.options.length > 0) {
+        schema.enum = setting.options.map((o) => o.value);
+        schema.description +=
+          ' Options: ' + setting.options.map((o) => `${o.value}`).join(', ');
+      } else {
+        // Enum without predefined options - accept any string
+        schema.type = 'string';
+      }
+      break;
+    case 'object':
+      schema.type = 'object';
+      if (setting.properties) {
+        schema.properties = {};
+        for (const [key, childDef] of Object.entries(setting.properties)) {
+          schema.properties[key] = convertSettingToJsonSchema(
+            childDef as SettingDefinition,
+          );
+        }
+      } else {
+        schema.additionalProperties = true;
+      }
+      break;
+  }
+
+  // Add default value for simple types only
+  if (setting.default !== undefined && setting.default !== null) {
+    const defaultVal = setting.default;
+    if (
+      typeof defaultVal === 'boolean' ||
+      typeof defaultVal === 'number' ||
+      typeof defaultVal === 'string'
+    ) {
+      schema.default = defaultVal;
+    } else if (Array.isArray(defaultVal) && defaultVal.length > 0) {
+      schema.default = defaultVal;
+    }
+  }
+
+  return schema;
+}
+
+function generateJsonSchema(
+  settingsSchema: SettingsSchema,
+): JsonSchemaProperty {
+  const jsonSchema: JsonSchemaProperty = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    type: 'object',
+    description: 'Qwen Code settings configuration',
+    properties: {},
+    additionalProperties: true,
+  };
+
+  for (const [key, setting] of Object.entries(settingsSchema)) {
+    jsonSchema.properties![key] = convertSettingToJsonSchema(
+      setting as SettingDefinition,
+    );
+  }
+
+  // Add $version property
+  jsonSchema.properties!['$version'] = {
+    type: 'number',
+    description: 'Settings schema version for migration tracking.',
+    default: 3,
+  };
+
+  return jsonSchema;
+}
+
+const schema = getSettingsSchema();
+const jsonSchema = generateJsonSchema(schema as unknown as SettingsSchema);
+
+const outputDir = path.resolve(
+  __dirname,
+  '../packages/vscode-ide-companion/schemas',
+);
+const outputPath = path.join(outputDir, 'settings.schema.json');
+
+fs.mkdirSync(outputDir, { recursive: true });
+fs.writeFileSync(outputPath, JSON.stringify(jsonSchema, null, 2) + '\n');
+
+console.log(`Generated settings JSON Schema at: ${outputPath}`);