chrome-cdp-cli 2.1.4 → 2.1.5

package/README.md

@@ -81,6 +81,9 @@ cdp log -f
 # Follow network requests in real time
 cdp network -f
 
+# List available Chrome pages
+cdp list
+
 # Element interactions
 cdp click "#submit-button"
 cdp fill "#email" "user@example.com"
@@ -126,6 +129,7 @@ Use arrow keys to navigate, Enter to select, `q`/ESC/Ctrl+C to cancel (exits cle
 To skip the prompt, pass `-i` before or after the command:
 
 ```bash
+cdp list
 cdp -i 1 eval "document.title"
 cdp eval "document.title" -i 1    # also works
 ```

package/dist/cli/CLIApplication.js

@@ -84,6 +84,12 @@ class CLIApplication {
             this.configureDebugMode(command.config.debug);
             this.logger.debug("CLIApplication.run called with argv:", argv);
             this.logger.debug("Parsed command:", command);
+            if (command.name === "list") {
+                const result = await this.executeListCommand(command);
+                this.outputResult(result, command);
+                return (result.exitCode ||
+                    (result.success ? CommandRouter_1.ExitCode.SUCCESS : CommandRouter_1.ExitCode.GENERAL_ERROR));
+            }
             if (this.needsConnection(command.name)) {
                 this.logger.debug("Command needs connection, ensuring connection...");
                 try {
@@ -131,11 +137,65 @@ class CLIApplication {
             "help",
             "connect",
             "disconnect",
+            "list",
             "install_cursor_command",
             "install_claude_skill",
         ];
         return !noConnectionCommands.includes(commandName);
     }
+    async executeListCommand(command) {
+        try {
+            const targets = await this.connectionManager.discoverTargets(command.config.host, command.config.port);
+            const selectableTargets = targets
+                .filter((target) => target.type === "page")
+                .filter((target) => !this.isDevToolsWindow(target));
+            if (command.config.outputFormat === "json") {
+                return {
+                    success: true,
+                    data: {
+                        count: selectableTargets.length,
+                        targets: selectableTargets.map((target, index) => ({
+                            index: index + 1,
+                            id: target.id,
+                            title: target.title || "(Untitled)",
+                            url: target.url,
+                            type: target.type,
+                        })),
+                    },
+                };
+            }
+            if (selectableTargets.length === 0) {
+                return {
+                    success: true,
+                    data: `No selectable Chrome pages found at ${command.config.host}:${command.config.port}.\n` +
+                        "Open a regular tab in Chrome and try again.",
+                };
+            }
+            const lines = [
+                `Found ${selectableTargets.length} selectable Chrome page(s):`,
+                "",
+                ...selectableTargets.flatMap((target, index) => [
+                    `[${index + 1}] ${target.title || "(Untitled)"}`,
+                    `    ${target.url}`,
+                ]),
+                "",
+                "Use `cdp -i <number> <command>` to target one of these pages.",
+            ];
+            return {
+                success: true,
+                data: lines.join("\n"),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error
+                    ? error.message
+                    : String(error),
+                exitCode: CommandRouter_1.ExitCode.CONNECTION_ERROR,
+            };
+        }
+    }
     isDevToolsWindow(target) {
         const url = target.url.toLowerCase();
         const title = target.title.toLowerCase();

package/dist/cli/CommandSchemaRegistry.js

@@ -55,6 +55,28 @@ class CommandSchemaRegistry {
             options: [],
             arguments: [],
         });
+        this.registerCommand({
+            name: "list",
+            aliases: ["ls"],
+            description: "List available Chrome pages you can target",
+            usage: "cdp [global-options] list",
+            examples: [
+                {
+                    command: "cdp list",
+                    description: "List selectable Chrome pages",
+                },
+                {
+                    command: "cdp --format json list",
+                    description: "List selectable Chrome pages as JSON",
+                },
+                {
+                    command: "cdp --host localhost --port 9223 list",
+                    description: "List pages from a specific Chrome instance",
+                },
+            ],
+            options: [],
+            arguments: [],
+        });
         this.registerCommand({
             name: "eval",
             aliases: ["js", "execute"],

package/dist/cli/HelpSystem.js

@@ -163,7 +163,7 @@ class HelpSystem {
                 orderedCategories.push([cat, categorizedCommands.get(cat)]);
             }
         }
-        for (const [cat, cmds] of categorizedCommands) {
+        for (const [cat, cmds] of Array.from(categorizedCommands.entries())) {
             if (!categoryOrder.includes(cat)) {
                 orderedCategories.push([cat, cmds]);
             }
@@ -310,11 +310,11 @@ class HelpSystem {
                 }
             }
         }
-        return [...new Set(similar)].slice(0, 5);
+        return Array.from(new Set(similar)).slice(0, 5);
     }
     findContextualSuggestions(error, commandName) {
         const suggestions = [];
-        for (const [errorPattern, helpers] of this.contextualHelpers) {
+        for (const [errorPattern, helpers] of Array.from(this.contextualHelpers.entries())) {
             if (error.toLowerCase().includes(errorPattern.toLowerCase())) {
                 suggestions.push(...helpers);
             }
@@ -351,7 +351,7 @@ class HelpSystem {
             else if (command.name.includes("install")) {
                 category = "Installation & Setup";
             }
-            else if (["help", "version"].includes(command.name)) {
+            else if (["help", "version", "list"].includes(command.name)) {
                 category = "Help & Information";
             }
             if (!categories.has(category)) {
@@ -359,7 +359,7 @@ class HelpSystem {
             }
             categories.get(category).push(command);
         }
-        for (const [, categoryCommands] of categories) {
+        for (const [, categoryCommands] of Array.from(categories.entries())) {
             categoryCommands.sort((a, b) => a.name.localeCompare(b.name));
         }
         return categories;

package/dist/client/CDPClient.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CDPClient = void 0;
-const ws_1 = __importDefault(require("ws"));
+const WebSocket = require("ws");
 const node_fetch_1 = __importDefault(require("node-fetch"));
 class CDPClient {
     constructor() {
@@ -26,7 +26,7 @@ class CDPClient {
                 targetId = pageTarget.id;
             }
             const wsUrl = await this.getWebSocketUrl(host, port, targetId);
-            this.ws = new ws_1.default(wsUrl);
+            this.ws = new WebSocket(wsUrl);
             return new Promise((resolve, reject) => {
                 if (!this.ws) {
                     reject(new Error('WebSocket not initialized'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-cdp-cli",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "Browser automation CLI via Chrome DevTools Protocol. Designed for developers and AI assistants - combines dedicated commands for common tasks with flexible JavaScript execution for complex scenarios. Features: element interaction, screenshots, DOM snapshots, console/network monitoring. Built-in IDE integration for Cursor and Claude.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",