opera-devtools-mcp 0.2.4 → 0.4.0

package/build/src/bin/chrome-devtools-mcp-cli-options.js

@@ -2,7 +2,11 @@
  * @license
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
+ *
+ * Modified by Opera Software AS.
  */
+import { CACHE_DIR_NAME, ENV_NO_USAGE_STATISTICS, MCP_BIN_NAME, PACKAGE_NAME, REPO_URL, } from '../opera/branding.js';
+import { PERFORMANCE_CRUX_DEFAULT, PERFORMANCE_CRUX_DESCRIPTION, USAGE_STATISTICS_DEFAULT, USAGE_STATISTICS_DESCRIPTION, } from '../opera/policy.js';
 import { yargs, hideBin } from '../third_party/index.js';
 export const cliOptions = {
     autoConnect: {
@@ -19,7 +23,7 @@ export const cliOptions = {
     },
     browserUrl: {
         type: 'string',
-        description: 'Connect to a running, debuggable Chrome instance (e.g. `http://127.0.0.1:9222`). For more details see: https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.',
+        description: `Connect to a running, debuggable Chrome instance (e.g. \`http://127.0.0.1:9222\`). For more details see: ${REPO_URL}#connecting-to-a-running-chrome-instance.`,
         alias: 'u',
         conflicts: ['wsEndpoint'],
         coerce: (url) => {
@@ -96,7 +100,7 @@ export const cliOptions = {
     },
     userDataDir: {
         type: 'string',
-        description: 'Path to the user data directory for Chrome. Default is $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE',
+        description: `Path to the user data directory for Chrome. Default is $HOME/.cache/${CACHE_DIR_NAME}/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE`,
         conflicts: ['browserUrl', 'wsEndpoint', 'isolated'],
     },
     channel: {
@@ -136,39 +140,40 @@ export const cliOptions = {
     },
     experimentalPageIdRouting: {
         type: 'boolean',
-        describe: 'Whether to expose pageId on page-scoped tools and route requests by page ID.',
-        hidden: true,
+        describe: 'Whether to expose pageId on page-scoped tools and route requests by page ID (useful for concurrent agent sessions).',
     },
     experimentalDevtools: {
         type: 'boolean',
         describe: 'Whether to enable automation over DevTools targets',
-        hidden: true,
     },
     experimentalVision: {
         type: 'boolean',
         describe: 'Whether to enable coordinate-based tools such as click_at(x,y). Usually requires a computer-use model able to produce accurate coordinates by looking at screenshots.',
-        hidden: false,
     },
-    experimentalMemory: {
+    memoryDebugging: {
         type: 'boolean',
-        describe: 'Whether to enable experimental memory tools.',
-        hidden: true,
+        describe: 'Whether to enable memory debugging tools.',
+        alias: 'experimentalMemory',
     },
     experimentalStructuredContent: {
         type: 'boolean',
         describe: 'Whether to output structured formatted content.',
-        hidden: true,
     },
-    experimentalIncludeAllPages: {
+    experimentalToonFormat: {
         type: 'boolean',
-        describe: 'Whether to include all kinds of pages such as webviews or background pages as pages.',
+        describe: 'Deprecated: use --experimentalDataFormat=toon instead. Whether to format structured data using TOON (requires @toon-format/toon).',
         hidden: true,
     },
-    experimentalNavigationAllowlist: {
-        type: 'boolean',
-        describe: 'Whether to enable navigation allowlist tool parameter.',
+    experimentalDataFormat: {
+        type: 'string',
+        describe: 'Override format for structured data in text responses. Default uses built-in formatters. "toon" (requires @toon-format/toon) or "gcf" (requires @blackwell-systems/gcf) replace structured content with the specified encoding.',
+        choices: ['default', 'toon', 'gcf'],
         hidden: true,
     },
+    experimentalIncludeAllPages: {
+        type: 'boolean',
+        describe: 'Whether to include all kinds of pages such as webviews or background pages as pages.',
+    },
     experimentalInteropTools: {
         type: 'boolean',
         describe: 'Whether to enable interoperability tools',
@@ -185,15 +190,25 @@ export const cliOptions = {
     },
     categoryExperimentalWebmcp: {
         type: 'boolean',
-        describe: 'Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`',
+        describe: 'Set to true to enable debugging WebMCP tools. Requires Chrome 150+ with the following flag: `--enable-features=WebMCP`',
     },
     chromeArg: {
         type: 'array',
-        describe: 'Additional arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.',
+        describe: `Additional arguments for Chrome. Only applies when Chrome is launched by ${MCP_BIN_NAME}.`,
+    },
+    blockedUrlPattern: {
+        type: 'array',
+        describe: "Restricts browser's network access by blocking specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Silently detaches from targets with blocked URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.",
+        conflicts: ['allowedUrlPattern'],
+    },
+    allowedUrlPattern: {
+        type: 'array',
+        describe: "Restricts browser's network access by allowing only specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Requires Chrome 149+. Silently detaches from targets with unallowed URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.",
+        conflicts: ['blockedUrlPattern'],
     },
     ignoreDefaultChromeArg: {
         type: 'array',
-        describe: 'Explicitly disable default arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.',
+        describe: `Explicitly disable default arguments for Chrome. Only applies when Chrome is launched by ${MCP_BIN_NAME}.`,
     },
     categoryEmulation: {
         type: 'boolean',
@@ -221,15 +236,21 @@ export const cliOptions = {
         default: false,
         describe: 'Set to true to enable third-party developer tools exposed by the inspected page itself',
     },
+    categoryPwa: {
+        type: 'boolean',
+        hidden: false,
+        conflicts: ['autoConnect', 'browserUrl', 'wsEndpoint'],
+        describe: 'Set to true to include tools for automating Progressive Web Apps (install, launch, uninstall, and OS state). This feature is only supported with a pipe connection; autoConnect, browserUrl, and wsEndpoint are not supported.',
+    },
     performanceCrux: {
         type: 'boolean',
-        default: true,
-        describe: 'Set to false to disable sending URLs from performance traces to CrUX API to get field performance data.',
+        default: PERFORMANCE_CRUX_DEFAULT,
+        describe: PERFORMANCE_CRUX_DESCRIPTION,
     },
     usageStatistics: {
         type: 'boolean',
-        default: true,
-        describe: 'Set to false to opt-out of usage statistics collection. Google collects usage data to improve the tool, handled under the Google Privacy Policy (https://policies.google.com/privacy). This is independent from Chrome browser metrics. Disabled if `CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS` or `CI` env variables are set.',
+        default: USAGE_STATISTICS_DEFAULT,
+        describe: USAGE_STATISTICS_DESCRIPTION,
     },
     clearcutEndpoint: {
         type: 'string',
@@ -246,6 +267,50 @@ export const cliOptions = {
         hidden: true,
         describe: 'Include watchdog PID in Clearcut request headers (for testing).',
     },
+    screenshotFormat: {
+        type: 'string',
+        description: 'Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which helps reduce context size in AI conversations. Unset preserves the existing default ("png").',
+        choices: ['jpeg', 'png', 'webp'],
+    },
+    screenshotQuality: {
+        type: 'number',
+        description: 'Override the default compression quality (0-100) used by take_screenshot for JPEG and WebP when the caller does not specify one. Lower values mean smaller files. Ignored for PNG. Unset preserves the Puppeteer default.',
+        coerce: (value) => {
+            if (value === undefined) {
+                return;
+            }
+            if (!Number.isInteger(value) || value < 0 || value > 100) {
+                throw new Error(`Invalid screenshotQuality ${value}. Expected an integer between 0 and 100.`);
+            }
+            return value;
+        },
+    },
+    screenshotMaxWidth: {
+        type: 'number',
+        description: 'Maximum width in pixels for screenshots. If the captured image is wider, it is downscaled (preserving aspect ratio) before being returned. Reduces context size in AI conversations. Unset means no resize.',
+        coerce: (value) => {
+            if (value === undefined) {
+                return;
+            }
+            if (!Number.isInteger(value) || value <= 0) {
+                throw new Error(`Invalid screenshotMaxWidth ${value}. Expected a positive integer.`);
+            }
+            return value;
+        },
+    },
+    screenshotMaxHeight: {
+        type: 'number',
+        description: 'Maximum height in pixels for screenshots. If the captured image is taller, it is downscaled (preserving aspect ratio) before being returned. Can be combined with --screenshot-max-width; the smaller scale factor wins. Unset means no resize.',
+        coerce: (value) => {
+            if (value === undefined) {
+                return;
+            }
+            if (!Number.isInteger(value) || value <= 0) {
+                throw new Error(`Invalid screenshotMaxHeight ${value}. Expected a positive integer.`);
+            }
+            return value;
+        },
+    },
     slim: {
         type: 'boolean',
         describe: 'Exposes a "slim" set of 3 tools covering navigation, script execution and screenshots only. Useful for basic browser tasks.',
@@ -257,15 +322,36 @@ export const cliOptions = {
     },
     redactNetworkHeaders: {
         type: 'boolean',
-        describe: 'If true, redacts some of the network headers considered senstive before returning to the client.',
+        describe: 'If true, redacts some of the network headers considered sensitive before returning to the client.',
+        default: false,
+    },
+    allowUnrestrictedPaths: {
+        type: 'boolean',
         default: false,
+        describe: 'If set, disables the default path restriction that applies when the MCP client does not negotiate ' +
+            'the roots capability. By default, file-writing tools are restricted to the OS temp directory when ' +
+            'no roots are configured. Use this only when connecting a trusted local client that does not implement ' +
+            'MCP roots and requires access to paths outside the temp directory.',
     },
 };
-export function parseArguments(version, argv = process.argv, env = process.env) {
+/**
+ * Exported only for testing to not trigger process exit.
+ */
+export function parser(version, argv = process.argv, env = process.env) {
+    // Preserve yargs' mixed camel/kebab-case expansion under strict validation.
+    const kebabCaseAliases = {};
+    for (const option of Object.keys(cliOptions)) {
+        const alias = option.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+        if (alias !== option) {
+            kebabCaseAliases[option] = alias;
+        }
+    }
     const yargsInstance = yargs(hideBin(argv))
-        .scriptName('npx chrome-devtools-mcp@latest')
+        .scriptName(`npx ${PACKAGE_NAME}@latest`)
         .options(cliOptions)
-        .check(args => {
+        .alias(kebabCaseAliases)
+        .strictOptions()
+        .middleware(args => {
         // We can't set default in the options else
         // Yargs will complain
         if (!args.channel &&
@@ -274,11 +360,10 @@ export function parseArguments(version, argv = process.argv, env = process.env)
             !args.executablePath) {
             args.channel = 'stable';
         }
-        if (env['CI'] || env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS']) {
-            console.error("turning off usage statistics. process.env['CI'] || process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS'] is set.");
+        if (env['CI'] || env[ENV_NO_USAGE_STATISTICS]) {
+            console.error(`turning off usage statistics. process.env['CI'] || process.env['${ENV_NO_USAGE_STATISTICS}'] is set.`);
             args.usageStatistics = false;
         }
-        return true;
     })
         .example([
         [
@@ -331,7 +416,7 @@ export function parseArguments(version, argv = process.argv, env = process.env)
         ],
         [
             '$0 --no-usage-statistics',
-            'Do not send usage statistics https://github.com/ChromeDevTools/chrome-devtools-mcp#usage-statistics.',
+            `Do not send usage statistics ${REPO_URL}#usage-statistics.`,
         ],
         [
             '$0 --no-performance-crux',
@@ -345,7 +430,9 @@ export function parseArguments(version, argv = process.argv, env = process.env)
     return yargsInstance
         .wrap(Math.min(120, yargsInstance.terminalWidth()))
         .help()
-        .version(version)
-        .parseSync();
+        .version(version);
+}
+export function parseArguments(version, argv = process.argv, env = process.env) {
+    return parser(version, argv, env).parseSync();
 }
 //# sourceMappingURL=chrome-devtools-mcp-cli-options.js.map

package/build/src/bin/chrome-devtools-mcp-main.js

@@ -2,32 +2,75 @@
  * @license
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
+ *
+ * Modified by Opera Software AS.
  */
-import '../polyfill.js';
+import '../utils/polyfill.js';
 import process from 'node:process';
+import { closeBrowser } from '../browser.js';
 import { createMcpServer, logDisclaimers } from '../index.js';
-import { logger, saveLogsToFile } from '../logger.js';
+import { ENV_CRASH_ON_UNCAUGHT, PACKAGE_NAME, PRODUCT_NAME, } from '../opera/branding.js';
+import { enforceTelemetryPolicy } from '../opera/policy.js';
 import { ClearcutLogger } from '../telemetry/ClearcutLogger.js';
 import { computeFlagUsage } from '../telemetry/flagUtils.js';
 import { StdioServerTransport } from '../third_party/index.js';
 import { checkForUpdates } from '../utils/check-for-updates.js';
+import { logger, saveLogsToFile } from '../utils/logger.js';
 import { VERSION } from '../version.js';
 import { cliOptions, parseArguments } from './chrome-devtools-mcp-cli-options.js';
-await checkForUpdates('Run `npm install chrome-devtools-mcp@latest` to update.');
+await checkForUpdates(`Run \`npm install ${PACKAGE_NAME}@latest\` to update.`);
 export const args = parseArguments(VERSION);
 const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
-if (process.env['CHROME_DEVTOOLS_MCP_CRASH_ON_UNCAUGHT'] !== 'true') {
+enforceTelemetryPolicy(args);
+if (process.env[ENV_CRASH_ON_UNCAUGHT] !== 'true') {
     process.on('unhandledRejection', (reason, promise) => {
-        logger('Unhandled promise rejection', promise, reason);
+        logger?.('Unhandled promise rejection', promise, reason);
     });
 }
-logger(`Starting Chrome DevTools MCP Server v${VERSION}`);
+logger?.(`Starting ${PRODUCT_NAME} v${VERSION}`);
+// Shutdown on stdin EOF (stdio MCP convention — the client closes the
+// transport to signal exit) and on standard termination signals. Without
+// this, an active Chrome subprocess keeps the Node event loop ref'd after
+// stdin closes and the server hangs until something else kills it.
+let shuttingDown = false;
+async function shutdown(reason) {
+    if (shuttingDown) {
+        return;
+    }
+    shuttingDown = true;
+    logger?.(`Shutting down (${reason})`);
+    // Backstop in case browser teardown hangs (e.g. unresponsive Chrome,
+    // slow beforeunload handlers, many tabs). Exits 0 because we still
+    // honored the shutdown request; the log line preserves observability.
+    // Unref'd so it doesn't keep the loop alive on the clean path.
+    setTimeout(() => {
+        logger?.('Shutdown timeout exceeded, forcing exit');
+        process.exit(0);
+    }, 5000).unref();
+    await closeBrowser();
+    process.exit(0);
+}
+process.stdin.on('end', () => {
+    void shutdown('stdin end');
+});
+process.stdin.on('close', () => {
+    void shutdown('stdin close');
+});
+process.on('SIGTERM', () => {
+    void shutdown('SIGTERM');
+});
+process.on('SIGINT', () => {
+    void shutdown('SIGINT');
+});
+process.on('SIGHUP', () => {
+    void shutdown('SIGHUP');
+});
 const { server } = await createMcpServer(args, {
     logFile,
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);
-logger('Chrome DevTools MCP Server connected');
+logger?.(`${PRODUCT_NAME} connected`);
 logDisclaimers(args);
 void ClearcutLogger.get()?.logDailyActiveIfNeeded();
 void ClearcutLogger.get()?.logServerStart(computeFlagUsage(args, cliOptions));

package/build/src/bin/chrome-devtools-mcp.js

@@ -3,20 +3,23 @@
  * @license
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
+ *
+ * Modified by Opera Software AS.
  */
-process.title = 'chrome-devtools-mcp';
 import { version } from 'node:process';
+import { MCP_BIN_NAME } from '../opera/branding.js';
+process.title = MCP_BIN_NAME;
 const [major, minor] = version.substring(1).split('.').map(Number);
 if (major === 20 && minor < 19) {
-    console.error(`ERROR: \`chrome-devtools-mcp\` does not support Node ${process.version}. Please upgrade to Node 20.19.0 LTS or a newer LTS.`);
+    console.error(`ERROR: \`${MCP_BIN_NAME}\` does not support Node ${process.version}. Please upgrade to Node 20.19.0 LTS or a newer LTS.`);
     process.exit(1);
 }
 if (major === 22 && minor < 12) {
-    console.error(`ERROR: \`chrome-devtools-mcp\` does not support Node ${process.version}. Please upgrade to Node 22.12.0 LTS or a newer LTS.`);
+    console.error(`ERROR: \`${MCP_BIN_NAME}\` does not support Node ${process.version}. Please upgrade to Node 22.12.0 LTS or a newer LTS.`);
     process.exit(1);
 }
 if (major < 20) {
-    console.error(`ERROR: \`chrome-devtools-mcp\` does not support Node ${process.version}. Please upgrade to Node 20.19.0 LTS or a newer LTS.`);
+    console.error(`ERROR: \`${MCP_BIN_NAME}\` does not support Node ${process.version}. Please upgrade to Node 20.19.0 LTS or a newer LTS.`);
     process.exit(1);
 }
 await import('./chrome-devtools-mcp-main.js');

package/build/src/bin/chrome-devtools.js

@@ -3,18 +3,21 @@
  * @license
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
+ *
+ * Modified by Opera Software AS.
  */
-process.title = 'chrome-devtools';
 import process from 'node:process';
-import { startDaemon, stopDaemon, sendCommand, handleResponse, } from '../daemon/client.js';
-import { isDaemonRunning, serializeArgs } from '../daemon/utils.js';
+import { startDaemon, stopDaemon, sendCommand, handleResponse, verifyDaemonVersion, } from '../daemon/client.js';
+import { isDaemonRunning, serializeArgs, assertValidSessionId, } from '../daemon/utils.js';
 import { logDisclaimers } from '../index.js';
+import { CLI_BIN_NAME, MCP_BIN_NAME, PACKAGE_NAME } from '../opera/branding.js';
 import { hideBin, yargs } from '../third_party/index.js';
 import { checkForUpdates } from '../utils/check-for-updates.js';
 import { VERSION } from '../version.js';
 import { commands } from './chrome-devtools-cli-options.js';
 import { cliOptions, parseArguments } from './chrome-devtools-mcp-cli-options.js';
-await checkForUpdates('Run `npm install -g chrome-devtools-mcp@latest` and `chrome-devtools start` to update and restart the daemon.');
+process.title = CLI_BIN_NAME;
+await checkForUpdates(`Run \`npm install -g ${PACKAGE_NAME}@latest\` and \`${CLI_BIN_NAME} start\` to update and restart the daemon.`);
 async function start(args, sessionId) {
     const combinedArgs = [...args, ...defaultArgs];
     await startDaemon(combinedArgs, sessionId);
@@ -41,22 +44,50 @@ startCliOptions.isolated.description =
     'If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed. Defaults to true unless userDataDir is provided.';
 startCliOptions.categoryExtensions.default = true;
 const y = yargs(hideBin(process.argv))
-    .scriptName('chrome-devtools')
+    .locale('en') // Force English to ensure error string matching works in .fail, all custom messages we output are in English anyways
+    .scriptName(CLI_BIN_NAME)
     .showHelpOnFail(true)
-    .usage('chrome-devtools <command> [...args] --flags')
-    .usage(`Run 'chrome-devtools <command> --help' for help on the specific command.`)
+    .usage(`${CLI_BIN_NAME} <command> [...args] --flags`)
+    .usage(`Run '${CLI_BIN_NAME} <command> --help' for help on the specific command.`)
     .option('sessionId', {
     type: 'string',
     description: 'Session ID for daemon scoping',
     default: '',
     hidden: true,
+    coerce: (sessionId) => {
+        assertValidSessionId(sessionId);
+        return sessionId;
+    },
 })
     .demandCommand()
     .version(VERSION)
     .strict()
     .help(true)
-    .wrap(120);
-y.command('start', 'Start or restart chrome-devtools-mcp', y => y
+    .wrap(120)
+    .fail((msg, err) => {
+    if (msg) {
+        console.error('Error:', msg);
+        if (msg.includes('Not enough non-option arguments') ||
+            msg.includes('Unknown argument') ||
+            msg.includes('Unknown arguments')) {
+            console.error('\n=========================================');
+            console.error('💡 TIP FOR AI AGENT / DEVELOPER:');
+            console.error('In the `chrome-devtools` CLI:');
+            console.error('1. Required parameters MUST be passed as positional arguments (without flags).');
+            console.error('   - INCORRECT: chrome-devtools evaluate_script --expression "() => document.title"');
+            console.error('   - CORRECT:   chrome-devtools evaluate_script "() => document.title"');
+            console.error('2. Optional parameters are passed as double-dash options/flags (e.g. --pageId 1).');
+            console.error('3. Make sure to escape quotes properly for your shell environment.');
+            console.error('Run `chrome-devtools <command> --help` to see exact positional and optional parameters.');
+            console.error('=========================================');
+        }
+    }
+    else if (err) {
+        console.error(err);
+    }
+    process.exit(1);
+});
+y.command('start', `Start or restart ${MCP_BIN_NAME}`, y => y
     .options(startCliOptions)
     .example('$0 start --browserUrl http://localhost:9222', 'Start the server connecting to an existing browser')
     .strict(), async (argv) => {
@@ -74,9 +105,9 @@ y.command('start', 'Start or restart chrome-devtools-mcp', y => y
     await start(args, argv.sessionId);
     process.exit(0);
 }).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', y => y, async (argv) => {
+y.command('status', `Checks if ${MCP_BIN_NAME} is running`, y => y, async (argv) => {
     if (isDaemonRunning(argv.sessionId)) {
-        console.log('chrome-devtools-mcp daemon is running.');
+        console.log(`${MCP_BIN_NAME} daemon is running.`);
         const response = await sendCommand({
             method: 'status',
         }, argv.sessionId);
@@ -84,6 +115,9 @@ y.command('status', 'Checks if chrome-devtools-mcp is running', y => y, async (a
             const data = JSON.parse(response.result);
             console.log(`pid=${data.pid} socket=${data.socketPath} start-date=${data.startDate} version=${data.version}`);
             console.log(`args=${JSON.stringify(data.args)}`);
+            if (data.version !== VERSION) {
+                console.warn(`Warning: Daemon server version (${data.version}) does not match CLI version (${VERSION}). Run 'chrome-devtools start' to update and restart the daemon.`);
+            }
         }
         else {
             console.error('Error:', response.error);
@@ -91,11 +125,11 @@ y.command('status', 'Checks if chrome-devtools-mcp is running', y => y, async (a
         }
     }
     else {
-        console.log('chrome-devtools-mcp daemon is not running.');
+        console.log(`${MCP_BIN_NAME} daemon is not running.`);
     }
     process.exit(0);
 });
-y.command('stop', 'Stop chrome-devtools-mcp if any', y => y, async (argv) => {
+y.command('stop', `Stop ${MCP_BIN_NAME} if any`, y => y, async (argv) => {
     const sessionId = argv.sessionId;
     if (!isDaemonRunning(sessionId)) {
         process.exit(0);
@@ -157,8 +191,11 @@ for (const [commandName, commandDef] of Object.entries(commands)) {
     }, async (argv) => {
         const sessionId = argv.sessionId;
         try {
+            const versionWarningPromise = isDaemonRunning(sessionId)
+                ? verifyDaemonVersion(sessionId, VERSION)
+                : Promise.resolve(undefined);
             if (!isDaemonRunning(sessionId)) {
-                await start([], sessionId);
+                await start(serializeArgs(cliOptions, argv), sessionId);
             }
             const commandArgs = {};
             for (const argName of Object.keys(args)) {
@@ -176,6 +213,12 @@ for (const [commandName, commandDef] of Object.entries(commands)) {
             }
             else {
                 console.error('Error:', response.error);
+            }
+            const versionWarning = await versionWarningPromise;
+            if (versionWarning) {
+                console.warn(versionWarning);
+            }
+            if (!response.success) {
                 process.exit(1);
             }
         }