docs: add note to extension tools

Author: nroscino

docs/tool-reference.md

@@ -398,6 +398,8 @@ in the DevTools Elements panel (if any).
 
 ## Extensions
 
+> NOTE: Extensions are not active by default. Use the '--category-extensions' flag
+
 ### `install_extension`
 
 **Description:** Installs a Chrome extension from the given path.

scripts/generate-docs.ts

@@ -13,7 +13,11 @@ import {get_encoding} from 'tiktoken';
 
 import {cliOptions} from '../build/src/bin/chrome-devtools-mcp-cli-options.js';
 import type {ParsedArguments} from '../build/src/bin/chrome-devtools-mcp-cli-options.js';
-import {ToolCategory, labels} from '../build/src/tools/categories.js';
+import {
+  ToolCategory,
+  OFF_BY_DEFAULT_CATEGORIES,
+  labels,
+} from '../build/src/tools/categories.js';
 import {createTools} from '../build/src/tools/tools.js';
 
 const OUTPUT_PATH = './docs/tool-reference.md';
@@ -351,6 +355,12 @@ async function generateReference(
 
     markdown += `## ${categoryName}\n\n`;
 
+    if (OFF_BY_DEFAULT_CATEGORIES.includes(category)) {
+      const flagName = `--category-${category}`;
+
+      markdown += `> NOTE: ${categoryName} are not active by default. Use the '${flagName}' flag\n\n`;
+    }
+
     // Sort tools within category
     categoryTools.sort((a: Tool, b: Tool) => a.name.localeCompare(b.name));
 

src/tools/categories.ts

@@ -27,3 +27,5 @@ export const labels = {
   [ToolCategory.IN_PAGE]: 'In-page tools',
   [ToolCategory.MEMORY]: 'Memory',
 };
+
+export const OFF_BY_DEFAULT_CATEGORIES = [ToolCategory.EXTENSIONS];