feat: add configureExtensionsIncludeGlobalTools setting (#187)

* add include global autoconfig setting

* Default to true for compatibility

* Update docs & walkthrough

Author: Attempt3035

README.md

@@ -45,9 +45,15 @@ The extension will notify you if neither is installed.
 > [!NOTE]
 > The extension includes default settings that you might want to change. See the [configuration guide](https://hverlin.github.io/mise-vscode/tutorials/settinguptheextension/) to customize your set-up.
 > For example, you can choose to enable/disable automatic configuration of other extensions or change the path to the `mise` binary.
-> 
+>
 > You can access the settings by clicking on the mise extension indicator in the status bar.
 
+### Recommended: Disable Global Tools in Auto-Configuration
+
+By default, the extension includes tools from your global mise configuration (`~/.config/mise/config.toml`) when auto-configuring other VS Code extensions. This can pollute your project settings with extensions for tools not in your current project.
+
+**Recommended setting:** Set `mise.configureExtensionsIncludeGlobalTools` to `false` to only use tools from your local `mise.toml` file. This keeps your `.vscode/settings.json` clean and ensures extensions are only configured for tools actually used in your project.
+
 ## ✨ Features
 
 The mise-vscode extension integrates mise's core functionality into VS Code, helping you manage your development environment directly from the editor. You can handle task running, tool versions, and environment variables through a simple interface. Here's what's available:

docs/src/content/docs/reference/Settings.md

@@ -147,6 +147,16 @@ This is useful if you share the `.vscode/settings.json` file with others. When t
 
 ---
 
+##### `mise.configureExtensionsIncludeGlobalTools`
+- **Type:** `boolean`
+- **Default:** `true`
+
+When enabled, tools from the global mise configuration (`~/.config/mise/config.toml`) will be included when automatically configuring VS Code extensions.
+
+When disabled (recommended), only tools from the local project configuration (`mise.toml`) are used. This prevents settings.json from being polluted with extensions for tools that are not part of the current project.
+
+---
+
 ##### `mise.checkForNewMiseVersion`
 - **Type:** `boolean`
 - **Default:** `true`

package.json

@@ -270,6 +270,13 @@
           "default": false,
           "markdownDescription": "Create symlinks in your `.vscode` folder that links to the `mise` bin.\n\nThis is useful if you share the `.vscode/settings.json` file with others. When the project is version controlled:\n- every user must have the extension installed\n- the directory `.vscode/mise-tools` must be excluded from version control."
         },
+        "mise.configureExtensionsIncludeGlobalTools": {
+          "order": 7.1,
+          "type": "boolean",
+          "title": "Include global mise tools when auto-configuring extensions",
+          "default": true,
+          "markdownDescription": "When enabled, tools from the global mise configuration (`~/.config/mise/config.toml`) will be included when automatically configuring VS Code extensions.\n\nWhen disabled (recommended), only tools from the local project configuration (`mise.toml`) are used. This prevents settings.json from being polluted with extensions for tools that are not part of the current project."
+        },
         "mise.checkForNewMiseVersion": {
           "order": 8,
           "type": "boolean",

src/configuration.ts

@@ -10,6 +10,8 @@ export const CONFIGURATION_FLAGS = {
 	configureExtensionsAutomatically: "configureExtensionsAutomatically",
 	configureExtensionsUseShims: "configureExtensionsUseShims",
 	configureExtensionsUseSymLinks: "configureExtensionsUseSymLinks",
+	configureExtensionsIncludeGlobalTools:
+		"configureExtensionsIncludeGlobalTools",
 	configureExtensionsAutomaticallyIgnoreList:
 		"configureExtensionsAutomaticallyIgnoreList",
 	configureExtensionsAutomaticallyIncludeList:
@@ -84,6 +86,13 @@ export const shouldUseSymLinks = () => {
 	);
 };
 
+export const shouldIncludeGlobalTools = (): boolean => {
+	return getConfOrElse(
+		CONFIGURATION_FLAGS.configureExtensionsIncludeGlobalTools,
+		true,
+	);
+};
+
 export const isMiseExtensionEnabled = (): boolean => {
 	return getConfOrElse(CONFIGURATION_FLAGS.enable, true);
 };

src/miseService.ts

@@ -412,17 +412,23 @@ export class MiseService {
 		}
 	}
 
-	async getCurrentTools(
-		{ useCache }: { useCache?: boolean } = { useCache: true },
-	): Promise<Array<MiseTool>> {
+	async getCurrentTools({
+		useCache = true,
+		local = false,
+	}: {
+		useCache?: boolean;
+		local?: boolean;
+	} = {}): Promise<Array<MiseTool>> {
 		if (!this.getMiseBinaryPath()) {
 			return [];
 		}
 
 		try {
 			const cacheInstance = useCache ? this.cache : this.dedupeCache;
 			const { stdout } = await cacheInstance.execCmd({
-				command: "ls --current --offline --json",
+				command: local
+					? "ls --local --offline --json"
+					: "ls --current --offline --json",
 			});
 
 			return Object.entries(JSON.parse(stdout)).flatMap(([toolName, tools]) => {

src/providers/toolsProvider.ts

@@ -18,6 +18,7 @@ import {
 	getIgnoreList,
 	getIncludeList,
 	isMiseExtensionEnabled,
+	shouldIncludeGlobalTools,
 	shouldUseShims,
 	shouldUseSymLinks,
 } from "../configuration";
@@ -636,7 +637,9 @@ export function registerToolsCommands(
 				}
 			}
 
-			const tools = await miseService.getCurrentTools();
+			const tools = shouldIncludeGlobalTools()
+				? await miseService.getCurrentTools()
+				: await miseService.getCurrentTools({ local: true });
 			const configurableTools = tools.filter((tool) => {
 				const configurableExtensions = extByToolName.get(tool.name);
 				if (!configurableExtensions?.length) {

walkthrough/auto-configure.md

@@ -12,6 +12,9 @@ One of the main features of this extension is the ability to **automatically con
 When enabled, the extension will automatically update your `.vscode/settings.json` file to configure supported VSCode extensions.
 See [the list of supported extensions](https://github.com/hverlin/mise-vscode/wiki/Supported-extensions).
 
+> [!IMPORTANT]
+> **Recommended:** Set `mise.configureExtensionsIncludeGlobalTools` to `false` to only use tools from your local `mise.toml` file. This prevents your project settings from being polluted with extensions for tools not in your current project.
+
 To enable this feature, simply click this button:
 **[Enable Auto-Configuration](command:mise.enableAutoConfiguration)**