skills/chromedevtools__chrome-devtools-mcp
1
0
Fork 0
mirror of https://github.com/ChromeDevTools/chrome-devtools-mcp.git synced 2026-09-14 19:45:30 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix(cli): improve error messages to guide AI agents and developers (#2161)

Browse Source 
Co-authored-by: Nicholas Roscino <nroscino@google.com>
Co-authored-by: Piotr Paulski <31672205+zyzyzyryxy@users.noreply.github.com>
Co-authored-by: Piotr Paulski <piotrpaulski@chromium.org>
This commit is contained in:
yasirusman85
2026-07-02 21:11:34 +05:00
committed by GitHub
parent a38ef5e7ea
commit cf00305170
1 changed files with 38 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/bin/chrome-devtools.ts
+38 -1
View File
@@ -62,6 +62,7 @@ startCliOptions.isolated!.description =
startCliOptions.categoryExtensions!.default = true;
const y = yargs(hideBin(process.argv))
.locale('en') // Force English to ensure error string matching works in .fail, all custom messages we output are in English anyways
.scriptName('chrome-devtools')
.showHelpOnFail(true)
.usage('chrome-devtools <command> [...args] --flags')
@@ -78,7 +79,43 @@ const y = yargs(hideBin(process.argv))
.version(VERSION)
.strict()
.help(true)
.wrap(120);
.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',