chore: fix arg forwarding

Author: OrKoN

src/bin/chrome-devtools.ts

@@ -44,7 +44,14 @@ const y = yargs(argv)
 y.command(
   'start',
   'Start or restart chrome-devtools-mcp',
-  y => y.help(false), // Disable help for start command to avoid parsing issues with passed args
+  y =>
+    y
+      .help(false) // Disable help for start command to avoid parsing issues with passed args.
+      .example(
+        '$0 start --port 8080 --url http://localhost:8080',
+        'Start the server on port 8080 with a specific URL',
+      )
+      .strict(false), // Don't validate arguments for start, as they are passed through to the daemon.
   async () => {
     if (isDaemonRunning()) {
       await stopDaemon();
@@ -54,7 +61,7 @@ y.command(
     const args = startIndex !== -1 ? process.argv.slice(startIndex + 1) : [];
     await startDaemon([...args, ...defaultArgs]);
   },
-);
+).strict(); // Re-enable strict validation for other commands; this is applied to the yargs instance itself
 
 y.command('status', 'Checks if chrome-devtools-mcp is running', async () => {
   if (isDaemonRunning()) {

tests/e2e/chrome-devtools.test.ts

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import assert from 'node:assert';
+import {spawnSync} from 'node:child_process';
+import path from 'node:path';
+import {describe, it, afterEach, beforeEach} from 'node:test';
+
+const CLI_PATH = path.resolve('build/src/bin/chrome-devtools.js');
+
+describe('chrome-devtools', () => {
+  const START_ARGS = ['--headless', '--isolated'];
+
+  beforeEach(() => {
+    spawnSync(CLI_PATH, ['stop']);
+  });
+
+  afterEach(() => {
+    spawnSync(CLI_PATH, ['stop']);
+  });
+
+  it('reports daemon status correctly', () => {
+    let result = spawnSync(CLI_PATH, ['status']);
+    assert.strictEqual(
+      result.stdout.toString(),
+      'chrome-devtools-mcp daemon is not running\n',
+    );
+
+    spawnSync(CLI_PATH, ['start', ...START_ARGS]);
+
+    result = spawnSync(CLI_PATH, ['status']);
+    assert.strictEqual(
+      result.stdout.toString(),
+      'chrome-devtools-mcp daemon is running.\n',
+    );
+  });
+
+  it('can start and stop the daemon', () => {
+    let result = spawnSync(CLI_PATH, ['status']);
+    assert.strictEqual(
+      result.stdout.toString(),
+      'chrome-devtools-mcp daemon is not running\n',
+    );
+
+    const startResult = spawnSync(CLI_PATH, ['start', ...START_ARGS]);
+    assert.strictEqual(
+      startResult.status,
+      0,
+      `start command failed: ${startResult.stderr.toString()}`,
+    );
+
+    result = spawnSync(CLI_PATH, ['status']);
+    assert.strictEqual(
+      result.stdout.toString(),
+      'chrome-devtools-mcp daemon is running.\n',
+    );
+
+    const stopResult = spawnSync(CLI_PATH, ['stop']);
+    assert.strictEqual(
+      stopResult.status,
+      0,
+      `stop command failed: ${stopResult.stderr.toString()}`,
+    );
+
+    result = spawnSync(CLI_PATH, ['status']);
+    assert.strictEqual(
+      result.stdout.toString(),
+      'chrome-devtools-mcp daemon is not running\n',
+    );
+  });
+
+  it('can invoke list_pages', async () => {
+    // Daemon should not be running.
+    let result = spawnSync(CLI_PATH, ['status']);
+    assert.strictEqual(
+      result.stdout.toString(),
+      'chrome-devtools-mcp daemon is not running\n',
+    );
+
+    const startResult = spawnSync(CLI_PATH, ['start', ...START_ARGS]);
+    assert.strictEqual(
+      startResult.status,
+      0,
+      `start command failed: ${startResult.stderr.toString()}`,
+    );
+
+    const listPagesResult = spawnSync(CLI_PATH, ['list_pages']);
+    assert.strictEqual(
+      listPagesResult.status,
+      0,
+      `list_pages command failed: ${listPagesResult.stderr.toString()}`,
+    );
+    assert(
+      listPagesResult.stdout.toString().includes('about:blank'),
+      'list_pages output is unexpected',
+    );
+
+    // Daemon should now be running.
+    result = spawnSync(CLI_PATH, ['status']);
+    assert.strictEqual(
+      result.stdout.toString(),
+      'chrome-devtools-mcp daemon is running.\n',
+    );
+  });
+
+  it('forwards disclaimers to stderr on start', () => {
+    const result = spawnSync(CLI_PATH, ['start', ...START_ARGS]);
+    assert.strictEqual(
+      result.status,
+      0,
+      `start command failed: ${result.stderr.toString()}`,
+    );
+    assert(
+      result.stderr.toString().includes('chrome-devtools-mcp exposes content'),
+      'Disclaimer not found in stderr on start',
+    );
+  });
+});