chrome-cdp-cli 2.0.5 → 2.1.1

package/dist/cli/HelpSystem.js

@@ -3,17 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelpSystem = void 0;
 const CommandSchemaRegistry_1 = require("./CommandSchemaRegistry");
 const colors = {
-    reset: '\x1b[0m',
-    bright: '\x1b[1m',
-    dim: '\x1b[2m',
-    red: '\x1b[31m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    blue: '\x1b[34m',
-    magenta: '\x1b[35m',
-    cyan: '\x1b[36m',
-    white: '\x1b[37m',
-    gray: '\x1b[90m',
+    reset: "\x1b[0m",
+    bright: "\x1b[1m",
+    dim: "\x1b[2m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    white: "\x1b[37m",
+    gray: "\x1b[90m",
 };
 const colorize = {
     title: (text) => `${colors.bright}${colors.cyan}${text}${colors.reset}`,
@@ -44,40 +44,40 @@ class HelpSystem {
         if (!command) {
             return this.generateCommandNotFoundHelp(commandName);
         }
-        let help = '';
+        let help = "";
         help += `${command.name.toUpperCase()}\n`;
-        help += '='.repeat(command.name.length) + '\n\n';
+        help += "=".repeat(command.name.length) + "\n\n";
         help += `${command.description}\n\n`;
         if (command.usage) {
-            help += 'USAGE\n';
-            help += '-----\n';
+            help += "USAGE\n";
+            help += "-----\n";
             help += `${command.usage}\n\n`;
         }
         if (command.arguments.length > 0) {
-            help += 'ARGUMENTS\n';
-            help += '---------\n';
+            help += "ARGUMENTS\n";
+            help += "---------\n";
             for (const arg of command.arguments) {
-                const required = arg.required ? ' (required)' : ' (optional)';
-                const variadic = arg.variadic ? '...' : '';
+                const required = arg.required ? " (required)" : " (optional)";
+                const variadic = arg.variadic ? "..." : "";
                 help += `  ${arg.name}${variadic}${required.padStart(30 - arg.name.length - variadic.length)}\n`;
                 help += `    ${arg.description}\n`;
-                if (arg.type !== 'string') {
+                if (arg.type !== "string") {
                     help += `    Type: ${arg.type}\n`;
                 }
-                help += '\n';
+                help += "\n";
             }
         }
         if (command.options.length > 0) {
-            help += 'OPTIONS\n';
-            help += '-------\n';
+            help += "OPTIONS\n";
+            help += "-------\n";
             for (const option of command.options) {
-                const shortFlag = option.short ? `-${option.short}, ` : '    ';
+                const shortFlag = option.short ? `-${option.short}, ` : "    ";
                 const longFlag = `--${option.name}`;
-                const negation = option.type === 'boolean' ? `, --no-${option.name}` : '';
+                const negation = option.type === "boolean" ? `, --no-${option.name}` : "";
                 const flags = `${shortFlag}${longFlag}${negation}`;
                 help += `  ${flags}\n`;
                 help += `    ${option.description}\n`;
-                if (option.type !== 'string') {
+                if (option.type !== "string") {
                     help += `    Type: ${option.type}\n`;
                 }
                 if (option.required) {
@@ -87,56 +87,58 @@ class HelpSystem {
                     help += `    Default: ${option.default}\n`;
                 }
                 if (option.choices && option.choices.length > 0) {
-                    help += `    Choices: ${option.choices.join(', ')}\n`;
+                    help += `    Choices: ${option.choices.join(", ")}\n`;
                 }
-                help += '\n';
+                help += "\n";
             }
         }
         if (command.examples && command.examples.length > 0) {
-            help += 'EXAMPLES\n';
-            help += '--------\n';
+            help += "EXAMPLES\n";
+            help += "--------\n";
             for (let i = 0; i < command.examples.length; i++) {
                 const example = command.examples[i];
-                help += `${i + 1}. ${example.description || 'Example usage'}\n`;
+                help += `${i + 1}. ${example.description || "Example usage"}\n`;
                 help += `   $ ${example.command}\n\n`;
             }
         }
         if (command.aliases.length > 0) {
-            help += 'ALIASES\n';
-            help += '-------\n';
-            help += `${command.aliases.join(', ')}\n\n`;
+            help += "ALIASES\n";
+            help += "-------\n";
+            help += `${command.aliases.join(", ")}\n\n`;
         }
         const relatedTopics = this.getRelatedHelpTopics(commandName);
         if (relatedTopics.length > 0) {
-            help += 'SEE ALSO\n';
-            help += '--------\n';
-            help += `Help topics: ${relatedTopics.join(', ')}\n`;
-            help += `Use 'chrome-cdp-cli help topic <topic-name>' for more information\n\n`;
+            help += "SEE ALSO\n";
+            help += "--------\n";
+            help += `Help topics: ${relatedTopics.join(", ")}\n`;
+            help += `Use 'cdp help topic <topic-name>' for more information\n\n`;
         }
         return help.trim();
     }
     generateGeneralHelp() {
-        let help = '';
-        help += `${colorize.title('CHROME DEVTOOLS CLI - ENHANCED HELP SYSTEM')}\n`;
-        help += `${colors.cyan}${'='.repeat(42)}${colors.reset}\n\n`;
-        help += 'A powerful command-line interface for Chrome DevTools Protocol automation.\n\n';
-        help += `${colorize.section('USAGE')}\n`;
-        help += `${colors.blue}${'-'.repeat(5)}${colors.reset}\n`;
-        help += `${colorize.command('chrome-cdp-cli')} [global-options] <command> [command-options] [arguments]\n\n`;
-        help += `${colorize.section('GLOBAL OPTIONS')}\n`;
-        help += `${colors.blue}${'-'.repeat(15)}${colors.reset}\n`;
-        help += `  ${colorize.option('-h, --host <host>')}        Chrome host address (default: localhost)\n`;
-        help += `  ${colorize.option('-p, --port <port>')}        DevTools port (default: 9222)\n`;
-        help += `  ${colorize.option('-f, --format <format>')}    Output format: json|text (default: text)\n`;
-        help += `  ${colorize.option('-v, --verbose')}            Enable verbose logging\n`;
-        help += `      ${colorize.option('--no-verbose')}         Disable verbose logging\n`;
-        help += `  ${colorize.option('-q, --quiet')}              Enable quiet mode\n`;
-        help += `      ${colorize.option('--no-quiet')}           Disable quiet mode\n`;
-        help += `  ${colorize.option('-t, --timeout <ms>')}       Command timeout in milliseconds (default: 30000)\n`;
-        help += `  ${colorize.option('-d, --debug')}              Enable debug logging\n`;
-        help += `      ${colorize.option('--no-debug')}           Disable debug logging\n`;
-        help += `  ${colorize.option('-c, --config <path>')}      Configuration file path\n`;
-        help += `      ${colorize.option('--version')}            Show version number\n\n`;
+        let help = "";
+        help += `${colorize.title("CDP - Chrome DevTools Protocol CLI")}\n`;
+        help += `${colors.cyan}${"=".repeat(35)}${colors.reset}\n\n`;
+        help +=
+            "A command-line interface for Chrome DevTools Protocol automation.\n\n";
+        help += `${colorize.section("USAGE")}\n`;
+        help += `${colors.blue}${"-".repeat(5)}${colors.reset}\n`;
+        help += `${colorize.command("cdp")} [global-options] <command> [command-options] [arguments]\n\n`;
+        help += `${colorize.section("GLOBAL OPTIONS")}\n`;
+        help += `${colors.blue}${"-".repeat(15)}${colors.reset}\n`;
+        help += `  ${colorize.option("-h, --host <host>")}        Chrome host address (default: localhost)\n`;
+        help += `  ${colorize.option("-p, --port <port>")}        DevTools port (default: 9222)\n`;
+        help += `  ${colorize.option("-f, --format <format>")}    Output format: json|text (default: text)\n`;
+        help += `  ${colorize.option("-v, --verbose")}            Enable verbose logging\n`;
+        help += `      ${colorize.option("--no-verbose")}         Disable verbose logging\n`;
+        help += `  ${colorize.option("-q, --quiet")}              Enable quiet mode\n`;
+        help += `      ${colorize.option("--no-quiet")}           Disable quiet mode\n`;
+        help += `  ${colorize.option("-t, --timeout <ms>")}       Command timeout in milliseconds (default: 30000)\n`;
+        help += `  ${colorize.option("-d, --debug")}              Enable debug logging\n`;
+        help += `      ${colorize.option("--no-debug")}           Disable debug logging\n`;
+        help += `  ${colorize.option("-c, --config <path>")}      Configuration file path\n`;
+        help += `  ${colorize.option("-i, --target-index <n>")}   Target page index, 1-based, excludes DevTools windows\n`;
+        help += `      ${colorize.option("--version")}            Show version number\n\n`;
         let commands;
         if (this.argumentParser && this.argumentParser.getCommands) {
             commands = this.argumentParser.getCommands();
@@ -145,25 +147,49 @@ class HelpSystem {
             commands = this.schemaRegistry.getAllCommands();
         }
         const categorizedCommands = this.categorizeCommands(commands);
-        help += `${colorize.section('AVAILABLE COMMANDS')}\n`;
-        help += `${colors.blue}${'-'.repeat(18)}${colors.reset}\n`;
-        for (const [categoryName, categoryCommands] of categorizedCommands) {
+        const categoryOrder = [
+            "Help & Information",
+            "JavaScript Execution",
+            "Page Capture",
+            "Monitoring & Debugging",
+            "User Interaction",
+            "Navigation & Timing",
+            "Installation & Setup",
+            "General",
+        ];
+        const orderedCategories = [];
+        for (const cat of categoryOrder) {
+            if (categorizedCommands.has(cat)) {
+                orderedCategories.push([cat, categorizedCommands.get(cat)]);
+            }
+        }
+        for (const [cat, cmds] of categorizedCommands) {
+            if (!categoryOrder.includes(cat)) {
+                orderedCategories.push([cat, cmds]);
+            }
+        }
+        help += `${colorize.section("AVAILABLE COMMANDS")}\n`;
+        help += `${colors.blue}${"-".repeat(18)}${colors.reset}\n`;
+        for (const [categoryName, categoryCommands] of orderedCategories) {
             help += `\n${colorize.category(categoryName)}:\n`;
             for (const command of categoryCommands) {
                 const commandName = colorize.command(command.name);
-                const aliases = command.aliases.length > 0 ? ` ${colorize.alias(`(${command.aliases.join(', ')})`)}` : '';
+                const aliases = command.aliases.length > 0
+                    ? ` ${colorize.alias(`(${command.aliases.join(", ")})`)}`
+                    : "";
                 const namePadding = Math.max(0, 20 - command.name.length);
-                const aliasText = command.aliases.length > 0 ? `(${command.aliases.join(', ')})` : '';
+                const aliasText = command.aliases.length > 0 ? `(${command.aliases.join(", ")})` : "";
                 const aliasPadding = Math.max(0, 15 - aliasText.length);
-                help += `  ${commandName}${' '.repeat(namePadding)}${aliases}${' '.repeat(aliasPadding)} ${command.description}\n`;
+                help += `  ${commandName}${" ".repeat(namePadding)}${aliases}${" ".repeat(aliasPadding)} ${command.description}\n`;
             }
         }
-        help += `\n${colorize.section('GETTING MORE HELP')}\n`;
-        help += `${colors.blue}${'-'.repeat(18)}${colors.reset}\n`;
-        help += 'For detailed help on a specific command:\n';
-        help += `  ${colorize.command('chrome-cdp-cli')} ${colorize.option('help')} <command>\n\n`;
-        help += 'For contextual help when commands fail:\n';
-        help += '  Commands automatically show relevant help suggestions on errors\n\n';
+        help += `\n${colorize.section("GETTING MORE HELP")}\n`;
+        help += `${colors.blue}${"-".repeat(18)}${colors.reset}\n`;
+        help += "For detailed help on a specific command:\n";
+        help += `  ${colorize.command("cdp")} ${colorize.option("help")} <command>\n\n`;
+        help += "For contextual help when commands fail:\n";
+        help +=
+            "  Commands automatically show relevant help suggestions on errors\n\n";
         return help.trim();
     }
     generateTopicHelp(topicName) {
@@ -171,70 +197,72 @@ class HelpSystem {
         if (!topic) {
             return this.generateTopicNotFoundHelp(topicName);
         }
-        let help = '';
+        let help = "";
         help += `${topic.title.toUpperCase()}\n`;
-        help += '='.repeat(topic.title.length) + '\n\n';
+        help += "=".repeat(topic.title.length) + "\n\n";
         help += `${topic.content}\n\n`;
         if (topic.examples && topic.examples.length > 0) {
-            help += 'EXAMPLES\n';
-            help += '--------\n';
+            help += "EXAMPLES\n";
+            help += "--------\n";
             for (let i = 0; i < topic.examples.length; i++) {
                 help += `${i + 1}. ${topic.examples[i]}\n`;
             }
-            help += '\n';
+            help += "\n";
         }
         if (topic.seeAlso && topic.seeAlso.length > 0) {
-            help += 'SEE ALSO\n';
-            help += '--------\n';
-            help += `${topic.seeAlso.join(', ')}\n\n`;
+            help += "SEE ALSO\n";
+            help += "--------\n";
+            help += `${topic.seeAlso.join(", ")}\n\n`;
         }
         return help.trim();
     }
     generateContextualHelp(error, commandName) {
-        let help = '';
+        let help = "";
         const suggestions = this.findContextualSuggestions(error, commandName);
         if (suggestions.length === 0) {
-            help += 'HELP SUGGESTIONS\n';
-            help += '----------------\n';
-            help += 'No specific suggestions available for this error.\n\n';
-            help += 'Try:\n';
-            help += '  - Check command syntax with: chrome-cdp-cli help <command>\n';
-            help += '  - Verify Chrome is running with --remote-debugging-port=9222\n';
-            help += '  - Use --debug flag for detailed error information\n\n';
+            help += "HELP SUGGESTIONS\n";
+            help += "----------------\n";
+            help += "No specific suggestions available for this error.\n\n";
+            help += "Try:\n";
+            help += "  - Check command syntax with: cdp help <command>\n";
+            help +=
+                "  - Verify Chrome is running with --remote-debugging-port=9222\n";
+            help += "  - Use --debug flag for detailed error information\n\n";
         }
         else {
-            help += 'HELP SUGGESTIONS\n';
-            help += '----------------\n';
+            help += "HELP SUGGESTIONS\n";
+            help += "----------------\n";
             for (let i = 0; i < suggestions.length; i++) {
                 const suggestion = suggestions[i];
                 help += `${i + 1}. ${suggestion.suggestion}\n`;
                 if (suggestion.example) {
                     help += `   Example: ${suggestion.example}\n`;
                 }
-                if (suggestion.relatedCommands && suggestion.relatedCommands.length > 0) {
-                    help += `   Related commands: ${suggestion.relatedCommands.join(', ')}\n`;
+                if (suggestion.relatedCommands &&
+                    suggestion.relatedCommands.length > 0) {
+                    help += `   Related commands: ${suggestion.relatedCommands.join(", ")}\n`;
                 }
-                help += '\n';
+                help += "\n";
             }
         }
         if (commandName) {
             help += `For detailed help on '${commandName}' command:\n`;
-            help += `  chrome-cdp-cli help ${commandName}\n\n`;
+            help += `  cdp help ${commandName}\n\n`;
         }
         return help.trim();
     }
     generateCommandNotFoundHelp(commandName) {
-        let help = '';
+        let help = "";
         help += `ERROR: Unknown command '${commandName}'\n\n`;
         const similarCommands = this.findSimilarCommands(commandName);
         if (similarCommands.length > 0) {
-            help += 'Did you mean:\n';
+            help += "Did you mean:\n";
             for (const similar of similarCommands) {
                 help += `  ${similar}\n`;
             }
-            help += '\n';
+            help += "\n";
         }
-        help += 'Available commands:\n';
+        help += "Available commands:\n";
         let commands;
         if (this.argumentParser && this.argumentParser.getCommands) {
             commands = this.argumentParser.getCommands();
@@ -245,20 +273,20 @@ class HelpSystem {
         for (const command of commands.sort((a, b) => a.name.localeCompare(b.name))) {
             help += `  ${command.name.padEnd(20)} ${command.description}\n`;
         }
-        help += '\nFor more information:\n';
-        help += '  chrome-cdp-cli help\n';
+        help += "\nFor more information:\n";
+        help += "  cdp help\n";
         return help;
     }
     generateTopicNotFoundHelp(topicName) {
-        let help = '';
+        let help = "";
         help += `ERROR: Unknown help topic '${topicName}'\n\n`;
-        help += 'Available help topics:\n';
+        help += "Available help topics:\n";
         const topics = Array.from(this.helpTopics.values()).sort((a, b) => a.name.localeCompare(b.name));
         for (const topic of topics) {
             help += `  ${topic.name.padEnd(20)} ${topic.description}\n`;
         }
-        help += '\nUsage:\n';
-        help += '  chrome-cdp-cli help topic <topic-name>\n';
+        help += "\nUsage:\n";
+        help += "  cdp help topic <topic-name>\n";
         return help;
     }
     findSimilarCommands(commandName) {
@@ -271,7 +299,8 @@ class HelpSystem {
         }
         const similar = [];
         for (const command of commands) {
-            if (command.name.includes(commandName) || commandName.includes(command.name)) {
+            if (command.name.includes(commandName) ||
+                commandName.includes(command.name)) {
                 similar.push(command.name);
             }
             for (const alias of command.aliases) {
@@ -301,28 +330,29 @@ class HelpSystem {
     categorizeCommands(commands) {
         const categories = new Map();
         for (const command of commands) {
-            let category = 'General';
-            if (['eval', 'execute', 'js'].includes(command.name)) {
-                category = 'JavaScript Execution';
+            let category = "General";
+            if (["eval", "execute", "js"].includes(command.name)) {
+                category = "JavaScript Execution";
             }
-            else if (['screenshot', 'capture', 'snapshot', 'dom'].includes(command.name)) {
-                category = 'Page Capture';
+            else if (["screenshot", "capture", "snapshot", "dom"].includes(command.name)) {
+                category = "Page Capture";
             }
-            else if (['click', 'hover', 'fill', 'type', 'drag', 'press', 'upload'].includes(command.name)) {
-                category = 'User Interaction';
+            else if (["log", "console", "network", "logs", "requests"].includes(command.name) ||
+                command.name.includes("console") ||
+                command.name.includes("network")) {
+                category = "Monitoring & Debugging";
             }
-            else if (['console', 'network', 'logs', 'requests'].includes(command.name) ||
-                command.name.includes('console') || command.name.includes('network')) {
-                category = 'Monitoring & Debugging';
+            else if (["click", "hover", "fill", "type", "drag", "press", "upload"].includes(command.name)) {
+                category = "User Interaction";
             }
-            else if (['navigate', 'goto', 'open', 'wait'].includes(command.name)) {
-                category = 'Navigation & Timing';
+            else if (["navigate", "goto", "open", "wait"].includes(command.name)) {
+                category = "Navigation & Timing";
             }
-            else if (command.name.includes('install')) {
-                category = 'Installation & Setup';
+            else if (command.name.includes("install")) {
+                category = "Installation & Setup";
             }
-            else if (['help', 'version'].includes(command.name)) {
-                category = 'Help & Information';
+            else if (["help", "version"].includes(command.name)) {
+                category = "Help & Information";
             }
             if (!categories.has(category)) {
                 categories.set(category, []);
@@ -337,15 +367,15 @@ class HelpSystem {
     getRelatedHelpTopics(commandName) {
         const related = [];
         const topicMappings = {
-            'eval': ['configuration', 'scripting'],
-            'screenshot': ['configuration', 'output-formats'],
-            'click': ['selectors', 'automation'],
-            'fill': ['selectors', 'automation'],
-            'hover': ['selectors', 'automation'],
-            'console_messages': ['monitoring', 'debugging'],
-            'network_requests': ['monitoring', 'debugging'],
-            'install_cursor_command': ['installation', 'integration'],
-            'install_claude_skill': ['installation', 'integration']
+            eval: ["configuration", "scripting"],
+            screenshot: ["configuration", "output-formats"],
+            click: ["selectors", "automation"],
+            fill: ["selectors", "automation"],
+            hover: ["selectors", "automation"],
+            console_messages: ["monitoring", "debugging"],
+            network_requests: ["monitoring", "debugging"],
+            install_cursor_command: ["installation", "integration"],
+            install_claude_skill: ["installation", "integration"],
         };
         const mappedTopics = topicMappings[commandName];
         if (mappedTopics) {
@@ -358,10 +388,10 @@ class HelpSystem {
         return related;
     }
     initializeHelpTopics() {
-        this.helpTopics.set('configuration', {
-            name: 'configuration',
-            title: 'Configuration Management',
-            description: 'Advanced configuration options and file formats',
+        this.helpTopics.set("configuration", {
+            name: "configuration",
+            title: "Configuration Management",
+            description: "Advanced configuration options and file formats",
             content: `The Chrome DevTools CLI supports multiple configuration sources with a clear precedence order:
 
 1. Command-line arguments (highest priority)
@@ -378,16 +408,16 @@ Configuration files can be in YAML or JSON format and support:
 
 Environment variables follow the pattern CDP_<OPTION_NAME> (e.g., CDP_HOST, CDP_PORT).`,
             examples: [
-                'chrome-cdp-cli --config ~/.chrome-cdp-cli.yaml eval "document.title"',
-                'CDP_HOST=remote-chrome CDP_PORT=9223 chrome-cdp-cli screenshot',
-                'chrome-cdp-cli --profile production screenshot --full-page'
+                'cdp --config ~/.cdp.yaml eval "document.title"',
+                "CDP_HOST=remote-chrome CDP_PORT=9223 cdp screenshot",
+                "cdp --profile production screenshot --full-page",
             ],
-            seeAlso: ['profiles', 'environment-variables']
+            seeAlso: ["profiles", "environment-variables"],
         });
-        this.helpTopics.set('selectors', {
-            name: 'selectors',
-            title: 'CSS Selectors Guide',
-            description: 'Guide to using CSS selectors effectively',
+        this.helpTopics.set("selectors", {
+            name: "selectors",
+            title: "CSS Selectors Guide",
+            description: "Guide to using CSS selectors effectively",
             content: `CSS selectors are used to target elements for interaction commands like click, fill, and hover.
 
 Supported selector types:
@@ -403,16 +433,16 @@ Best practices:
 - Test selectors in browser DevTools first
 - Use :visible pseudo-selector for visible elements only`,
             examples: [
-                'chrome-cdp-cli click "#submit-button"',
-                'chrome-cdp-cli fill "[data-testid=username]" "user@example.com"',
-                'chrome-cdp-cli hover ".dropdown-menu > .first-item"'
+                'cdp click "#submit-button"',
+                'cdp fill "[data-testid=username]" "user@example.com"',
+                'cdp hover ".dropdown-menu > .first-item"',
             ],
-            seeAlso: ['automation', 'debugging']
+            seeAlso: ["automation", "debugging"],
         });
-        this.helpTopics.set('automation', {
-            name: 'automation',
-            title: 'Browser Automation Best Practices',
-            description: 'Guidelines for effective browser automation',
+        this.helpTopics.set("automation", {
+            name: "automation",
+            title: "Browser Automation Best Practices",
+            description: "Guidelines for effective browser automation",
             content: `Effective browser automation requires careful planning and robust selectors.
 
 Key principles:
@@ -428,15 +458,15 @@ Common patterns:
 - Take screenshots for debugging failed tests
 - Monitor console and network for errors`,
             examples: [
-                'chrome-cdp-cli navigate "https://example.com" && chrome-cdp-cli wait "#content" && chrome-cdp-cli click ".login"',
-                'chrome-cdp-cli fill "#username" "user" && chrome-cdp-cli fill "#password" "pass" && chrome-cdp-cli click "#login"'
+                'cdp navigate "https://example.com" && cdp wait "#content" && cdp click ".login"',
+                'cdp fill "#username" "user" && cdp fill "#password" "pass" && cdp click "#login"',
             ],
-            seeAlso: ['selectors', 'debugging', 'scripting']
+            seeAlso: ["selectors", "debugging", "scripting"],
         });
-        this.helpTopics.set('output-formats', {
-            name: 'output-formats',
-            title: 'Output Formats and Processing',
-            description: 'Understanding different output formats and processing options',
+        this.helpTopics.set("output-formats", {
+            name: "output-formats",
+            title: "Output Formats and Processing",
+            description: "Understanding different output formats and processing options",
             content: `The CLI supports multiple output formats for different use cases:
 
 Text format (default):
@@ -459,16 +489,16 @@ Verbose mode:
 - Shows timing and performance data
 - Helpful for debugging and optimization`,
             examples: [
-                'chrome-cdp-cli --format json eval "document.title"',
-                'chrome-cdp-cli --quiet screenshot --filename result.png',
-                'chrome-cdp-cli --verbose --debug console_messages'
+                'cdp --format json eval "document.title"',
+                "cdp --quiet screenshot --filename result.png",
+                "cdp --verbose --debug console_messages",
             ],
-            seeAlso: ['configuration', 'scripting']
+            seeAlso: ["configuration", "scripting"],
         });
-        this.helpTopics.set('debugging', {
-            name: 'debugging',
-            title: 'Debugging and Troubleshooting',
-            description: 'Tools and techniques for debugging CLI issues',
+        this.helpTopics.set("debugging", {
+            name: "debugging",
+            title: "Debugging and Troubleshooting",
+            description: "Tools and techniques for debugging CLI issues",
             content: `When commands don't work as expected, use these debugging techniques:
 
 Debug mode (--debug):
@@ -492,16 +522,16 @@ Monitoring commands:
 - Use network_requests to verify API calls
 - Take screenshots to see current page state`,
             examples: [
-                'chrome-cdp-cli --debug --verbose click "#button"',
-                'chrome-cdp-cli console_messages --filter error',
-                'chrome-cdp-cli screenshot --filename debug.png'
+                'cdp --debug --verbose click "#button"',
+                "cdp console_messages --filter error",
+                "cdp screenshot --filename debug.png",
             ],
-            seeAlso: ['monitoring', 'automation']
+            seeAlso: ["monitoring", "automation"],
         });
-        this.helpTopics.set('scripting', {
-            name: 'scripting',
-            title: 'Scripting and Integration',
-            description: 'Using the CLI in scripts and automation workflows',
+        this.helpTopics.set("scripting", {
+            name: "scripting",
+            title: "Scripting and Integration",
+            description: "Using the CLI in scripts and automation workflows",
             content: `The CLI is designed for integration with shell scripts, CI/CD pipelines, and automation tools.
 
 Shell scripting tips:
@@ -524,15 +554,15 @@ CI/CD integration:
 - Capture screenshots on test failures
 - Monitor console errors in automated tests`,
             examples: [
-                '#!/bin/bash\nif chrome-cdp-cli eval "document.readyState === \'complete\'"; then\n  chrome-cdp-cli screenshot\nfi',
-                'chrome-cdp-cli --format json eval "performance.timing" | jq .data.loadEventEnd'
+                "#!/bin/bash\nif cdp eval \"document.readyState === 'complete'\"; then\n  cdp screenshot\nfi",
+                'cdp --format json eval "performance.timing" | jq .data.loadEventEnd',
             ],
-            seeAlso: ['configuration', 'output-formats']
+            seeAlso: ["configuration", "output-formats"],
         });
-        this.helpTopics.set('installation', {
-            name: 'installation',
-            title: 'Installation and Setup',
-            description: 'Setting up the CLI and integrations',
+        this.helpTopics.set("installation", {
+            name: "installation",
+            title: "Installation and Setup",
+            description: "Setting up the CLI and integrations",
             content: `The CLI can be integrated with various development tools and IDEs.
 
 Chrome setup:
@@ -546,8 +576,8 @@ IDE integrations:
 - VS Code: Create custom tasks and snippets
 
 Configuration setup:
-- Create ~/.chrome-cdp-cli.yaml for global settings
-- Use project-specific .chrome-cdp-cli.yaml files
+- Create ~/.cdp.yaml for global settings
+- Use project-specific .cdp.yaml files
 - Set up environment variables for CI/CD
 
 Plugin development:
@@ -555,113 +585,113 @@ Plugin development:
 - Register commands with proper schemas
 - Include comprehensive help documentation`,
             examples: [
-                'chrome --remote-debugging-port=9222 --headless',
-                'chrome-cdp-cli install_cursor_command --target-directory ./commands',
-                'chrome-cdp-cli install_claude_skill --skill-type automation'
+                "chrome --remote-debugging-port=9222 --headless",
+                "cdp install_cursor_command --target-directory ./commands",
+                "cdp install_claude_skill --skill-type automation",
             ],
-            seeAlso: ['configuration', 'integration']
+            seeAlso: ["configuration", "integration"],
         });
     }
     initializeContextualHelpers() {
-        this.contextualHelpers.set('connection refused', [
+        this.contextualHelpers.set("connection refused", [
             {
-                error: 'connection refused',
-                suggestion: 'Make sure Chrome is running with remote debugging enabled',
-                example: 'chrome --remote-debugging-port=9222',
-                relatedCommands: ['help']
+                error: "connection refused",
+                suggestion: "Make sure Chrome is running with remote debugging enabled",
+                example: "chrome --remote-debugging-port=9222",
+                relatedCommands: ["help"],
             },
             {
-                error: 'connection refused',
-                suggestion: 'Check if the host and port are correct',
-                example: 'chrome-cdp-cli --host localhost --port 9222 <command>',
-                relatedCommands: ['help']
-            }
+                error: "connection refused",
+                suggestion: "Check if the host and port are correct",
+                example: "cdp --host localhost --port 9222 <command>",
+                relatedCommands: ["help"],
+            },
         ]);
-        this.contextualHelpers.set('element not found', [
+        this.contextualHelpers.set("element not found", [
             {
-                error: 'element not found',
-                suggestion: 'Verify the CSS selector in browser DevTools',
+                error: "element not found",
+                suggestion: "Verify the CSS selector in browser DevTools",
                 example: 'Open DevTools → Console → document.querySelector("#your-selector")',
-                relatedCommands: ['help topic selectors']
+                relatedCommands: ["help topic selectors"],
             },
             {
-                error: 'element not found',
-                suggestion: 'Wait for the page to load completely before interacting',
-                example: 'chrome-cdp-cli wait "#element" && chrome-cdp-cli click "#element"',
-                relatedCommands: ['wait']
-            }
+                error: "element not found",
+                suggestion: "Wait for the page to load completely before interacting",
+                example: 'cdp wait "#element" && cdp click "#element"',
+                relatedCommands: ["wait"],
+            },
         ]);
-        this.contextualHelpers.set('timeout', [
+        this.contextualHelpers.set("timeout", [
             {
-                error: 'timeout',
-                suggestion: 'Increase the timeout value for slow operations',
-                example: 'chrome-cdp-cli --timeout 60000 <command>',
-                relatedCommands: ['help']
+                error: "timeout",
+                suggestion: "Increase the timeout value for slow operations",
+                example: "cdp --timeout 60000 <command>",
+                relatedCommands: ["help"],
             },
             {
-                error: 'timeout',
-                suggestion: 'Check if the page is loading or if there are network issues',
-                example: 'chrome-cdp-cli console_messages --filter error',
-                relatedCommands: ['console_messages', 'network_requests']
-            }
+                error: "timeout",
+                suggestion: "Check if the page is loading or if there are network issues",
+                example: "cdp console_messages --filter error",
+                relatedCommands: ["console_messages", "network_requests"],
+            },
         ]);
-        this.contextualHelpers.set('parse error', [
+        this.contextualHelpers.set("parse error", [
             {
-                error: 'parse error',
-                suggestion: 'Check command syntax and argument order',
-                example: 'chrome-cdp-cli help <command-name>',
-                relatedCommands: ['help']
+                error: "parse error",
+                suggestion: "Check command syntax and argument order",
+                example: "cdp help <command-name>",
+                relatedCommands: ["help"],
             },
             {
-                error: 'parse error',
-                suggestion: 'Use quotes around arguments containing spaces or special characters',
-                example: 'chrome-cdp-cli eval "document.querySelector(\'.my-class\')"',
-                relatedCommands: ['help topic scripting']
-            }
+                error: "parse error",
+                suggestion: "Use quotes around arguments containing spaces or special characters",
+                example: "cdp eval \"document.querySelector('.my-class')\"",
+                relatedCommands: ["help topic scripting"],
+            },
         ]);
-        this.contextualHelpers.set('validation failed', [
+        this.contextualHelpers.set("validation failed", [
             {
-                error: 'validation failed',
-                suggestion: 'Check required arguments and option types',
-                example: 'chrome-cdp-cli help <command-name>',
-                relatedCommands: ['help']
+                error: "validation failed",
+                suggestion: "Check required arguments and option types",
+                example: "cdp help <command-name>",
+                relatedCommands: ["help"],
             },
             {
-                error: 'validation failed',
-                suggestion: 'Ensure file paths exist and URLs are valid',
-                example: 'ls -la /path/to/file.js',
-                relatedCommands: ['help topic debugging']
-            }
+                error: "validation failed",
+                suggestion: "Ensure file paths exist and URLs are valid",
+                example: "ls -la /path/to/file.js",
+                relatedCommands: ["help topic debugging"],
+            },
         ]);
-        this.contextualHelpers.set('permission denied', [
+        this.contextualHelpers.set("permission denied", [
             {
-                error: 'permission denied',
-                suggestion: 'Check file permissions and directory access',
-                example: 'chmod +r /path/to/file',
-                relatedCommands: ['help topic debugging']
+                error: "permission denied",
+                suggestion: "Check file permissions and directory access",
+                example: "chmod +r /path/to/file",
+                relatedCommands: ["help topic debugging"],
             },
             {
-                error: 'permission denied',
-                suggestion: 'Ensure the target directory exists and is writable',
-                example: 'mkdir -p /path/to/directory && chmod +w /path/to/directory',
-                relatedCommands: ['help topic installation']
-            }
+                error: "permission denied",
+                suggestion: "Ensure the target directory exists and is writable",
+                example: "mkdir -p /path/to/directory && chmod +w /path/to/directory",
+                relatedCommands: ["help topic installation"],
+            },
         ]);
-        this.contextualHelpers.set('command:eval', [
+        this.contextualHelpers.set("command:eval", [
             {
-                error: 'eval',
-                suggestion: 'Use proper JavaScript syntax and escape quotes',
-                example: 'chrome-cdp-cli eval "document.querySelector(\\"#id\\").textContent"',
-                relatedCommands: ['help eval', 'help topic scripting']
-            }
+                error: "eval",
+                suggestion: "Use proper JavaScript syntax and escape quotes",
+                example: 'cdp eval "document.querySelector(\\"#id\\").textContent"',
+                relatedCommands: ["help eval", "help topic scripting"],
+            },
         ]);
-        this.contextualHelpers.set('command:screenshot', [
+        this.contextualHelpers.set("command:screenshot", [
             {
-                error: 'screenshot',
-                suggestion: 'Ensure the output directory exists and is writable',
-                example: 'mkdir -p screenshots && chrome-cdp-cli screenshot --filename screenshots/page.png',
-                relatedCommands: ['help screenshot']
-            }
+                error: "screenshot",
+                suggestion: "Ensure the output directory exists and is writable",
+                example: "mkdir -p screenshots && cdp screenshot --filename screenshots/page.png",
+                relatedCommands: ["help screenshot"],
+            },
         ]);
     }
     getAvailableTopics() {