feat: support remote CDP WebSocket URLs in --cdp flag (#99)

Previously, the --cdp flag only accepted a port number and connected via
http://localhost:{port}. This made it impossible to connect to remote
browser services like Kernel, Browserless, etc. that provide WebSocket URLs.

The --cdp flag now accepts either:
- A port number (e.g., 9222) for local connections
- A full WebSocket URL (e.g., wss://...) for remote browser services

Changes:
- Added cdpUrl field to LaunchCommand type
- Updated protocol validation to accept URL format with scheme validation
- Modified connectViaCDP to detect and handle both formats
- Handle numeric strings for JSON serialization edge cases
- Updated CLI to send cdpUrl or cdpPort based on input format
- Updated README with examples for remote connections

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

This commit is contained in:

Rafael

2026-01-21 21:11:14 -06:00

committed by

GitHub

co-authored by

Claude Opus 4.5

parent c4139fa389

commit e892bceadf

5 changed files with 131 additions and 55 deletions

									
										src/types.ts
									
		+1
		
												View File
												
				@@ -15,6 +15,7 @@ export interface LaunchCommand extends BaseCommand {

				  headers?: Record<string, string>;

				  executablePath?: string;

				  cdpPort?: number;

				  cdpUrl?: string;

				  extensions?: string[];

				  proxy?: {

				    server: string;