CHANGELOG.md

Changelog

0.19.0 (2026-03-05)

🎉 Features

• add pageId routing for parallel multi-agent workflows (#1022) (caf601a), closes #1019
• Add skill which helps with onboarding of the mcp server (#1083) (7273f16)
• integrate Lighthouse audits (#831) (dfdac26)

🛠️ Fixes

• improve error messages around --auto-connect (#1075) (bcb852d)
• improve tool descriptions (#965) (bdbbc84)
• repair broken markdown and extract snippets in a11y-debugging skill (#1096) (adac7c5)
• simplify emulation and script tools (#1073) (e51ba47)
• simplify focus state management (#1063) (f763da2)
• tweak lighthouse description (#1112) (5538180)

📄 Documentation

• Adapt a11y skill to utilize Lighthouse (#1054) (21634e6)
• add feature release checklist to CONTRIBUTING.md (#1118) (0378457)
• fix typo in README regarding slim mode (#1093) (92f2c7b)

🏗️ Refactor

• clean up more of the context getters (#1062) (9628dab)
• consistently use McpPage in tools (#1057) (302e5a0)
• improve type safety for page scoped tools (#1051) (5f694c6)
• make cdp resolvers use McpPage (#1060) (d6c06c5)
• move dialog handling to McpPage (#1059) (40c241b)
• move server to a separate file (#1043) (a8bf3e5)
• remove page passing via context (#1061) (4cb5a17)
• set defaults to performance trace tool (#1090) (dfa9b79)
• simplify the response texts (#1095) (cb0079e)
• type-cast as internal CdpPage interface (#1064) (2d5e4fa)

0.18.1 (2026-02-25)

🛠️ Fixes

• remove endsWith for filePath in memory tools (#1041) (d0622d5)

0.18.0 (2026-02-24)

🎉 Features

• --slim mode for maximum token savings (#958) (c402b43)
• add a new skill for accessibility debugging and auditing with Chrome DevTools MCP. (#1002) (b0c6d04)
• add experimental screencast recording tools (#941) (33446d4)
• add skill to debug and optimize LCP (#993) (2cd9b95)
• add storage-isolated browser contexts (#991) (59f6477)
• add take_memory_snapshot tool (#1023) (7ffdc5e)
• support any-match text arrays in wait_for (#1011) (496ab1b)
• support type_text (#1026) (b5d01b5)

🛠️ Fixes

• detect X server display on Linux (#1027) (1746ed9)

♻️ Chores

• cleanup string and structured console formatters (#1005) (0d78685)
• extract version in a seprate file (#1032) (0106865)
• move emulation settings to context (#1000) (bc3c40e)
• optimize slim tool descriptions and params (#1028) (ca6635d)
• simplify JavaScript code examples, update code block language, and refine descriptions in a11y debugging skill documentation. (#1009) (5cedcaa)
• types for JSON output of IssueFormatter (#1007) (9ef4479)

0.17.3 (2026-02-19)

🛠️ Fixes

• remove clean from prepare (#997) (2016b98)

0.17.2 (2026-02-19)

🛠️ Fixes

• check that combobox is actually a select element before filling out options (#979) (d2bc489)
• handle network request pagination correctly (#980) (0d9f422)

📄 Documentation

• Add a note about previously installed server installations (#982) (c0009f7)
• update codex doc URL (#987) (ebbbea7)

♻️ Chores

• network: de-duplicate String and JSON formatters (#985) (1896dbb)
• remove text from the status code for Network requests (#778) (327a388)

0.17.1 (2026-02-16)

📄 Documentation

• Add 'Progressive Complexity' and 'Reference over Value' design principles. (#939) (8d765c0)
• add Katalon Studio setup instructions to README (#929) (6cfef24)
• add MCP config for Claude plugin + docs (#944) (a781da4)
• estimate tokens using tiktoken (#959) (fd0a919)
• improve Claude Code installation instructions (#947) (3ec5b7e)
• Update README with WSL configuration details (#946) (107c46a)

♻️ Chores

• rename files to have more consistent style (#935) (9e1f9ac)

0.17.0 (2026-02-10)

🎉 Features

• include Error.cause chain for uncaught errors and logged Errors (#906) (05b01ec)
• Integrate CrUX data into performance trace summaries (#733) (b747f9d)
• show message and stack trace in details when console.log'ging Error objects (#902) (ffa00da)

🛠️ Fixes

• console formatter hides frames from ignored scripts (#927) (8e2380b)
• limit stack traces to 50 lines (#923) (caea23a)

📄 Documentation

• add macOS Web Bluetooth troubleshooting note (#930) (3c9528b), closes #917

0.16.0 (2026-02-04)

🎉 Features

• include source-mapped stack trace for uncaught errors (#876) (ecef712)

🛠️ Fixes

• accidental extra typing in the fill tool (#886) (3d6e59d)
• update evaluateScript description formatting (#880) (24db9dd)
• use 1-based line/column and fix wasm offsets in stack frames (#884) (7e1ec81)

📄 Documentation

• mention source-mapped stack traces in 'Key features' (#883) (579d18a)
• remove outdated --channel=beta note (#882) (acdb5c9)

0.15.1 (2026-01-30)

🛠️ Fixes

• disable usage statistics when CI or CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS env is set (#862) (c0435a2)
• respect custom timeouts in navigate tools (#865) (a0aeb97)

0.15.0 (2026-01-28)

🎉 Features

• Add ability to inject script to run on page load (#568) (d845ad4)
• enable usage statistics by default with opt-out (#855) (7e279f1)
• support testing light and dark mode (#858) (5a23a8c)

0.14.0 (2026-01-27)

🎉 Features

• add a skill for using chrome-devtools-mcp (#830) (aa0a367)
• add background parameter to new_page tool (#837) (d756888)
• allow skipping snapshot generation for input tools (#821) (4b8e9f2)
• include stack trace in 'get_console_message' tool (#740) (a3a0021)
• support device viewport and user agent emulation (#798) (a816967)
• support filePath for network request and response bodies (#795) (6d0e4ca)

🛠️ Fixes

• handle beforeunload dialogs in navigations (#788) (9b21f8b)
• improve error handling for console messages (#844) (dc43ede)
• improve error reporting when retrieving the element (#845) (f7dd003)
• improve performance tool description (#800) (aa9a176)
• increase timeouts for long text input (#787) (a83a338)
• make request and response handling more robust (#846) (695817f)
• re-use node ids across snapshots (#814) (a6cd2cd)

📄 Documentation

• add a mention of evals into contributing.md (#773) (9a31ac7)
• document how to add extensions to gemini-cli (#834) (0610d11)
• update auto-connect docs (#779) (a106fba)
• Update README.md to include a link to Android debugging (#783) (6e52e66)

0.13.0 (2026-01-14)

🎉 Features

• Allow opting out of default Chrome launch arguments (#729) (9a51af2)
• support filePath in performance tools (#686) (68ae2f8)

🛠️ Fixes

• support resize_page when browser window is maximized/fullscreenwindow state (#748) (4d9ac22)
• use relative path for plugin source in marketplace (#724) (5c1ecf8)

📄 Documentation

• add experimental chrome on android guide (#691) (4a87702)
• autoConnect - clarify how the mcp server selects a profile (#693) (28b8ff8)
• claude code broken link (#707) (1f532b8)
• enhance cli docs + sort required vs opt params (#674) (81cbd99)
• update auto connect docs to mention min Chrome version (#681) (ab2340f)
• Update Claude Code instructions in README.md (#711) (f81cd2d)
• update readme to include OpenCode example (#560) (fbba3c9)

♻️ Chores

• change pageIdx to page ids (#741) (a23c6ba)

0.12.1 (2025-12-12)

🛠️ Fixes

• catch unexpected error in event handlers (#672) (ca0f560)
• log unhandledRejection instead of crashing (#673) (f59b4a2)
• make bringToFront optional in select_page (#668) (ceae17b)
• Update installation badges in README.md for VS Code (#660) (61ede1c)

📄 Documentation

• Add debug instructions (#670) (a8aae66)
• explain new auto connection feature (#664) (a537a8c)

0.12.0 (2025-12-09)

🎉 Features

• support --auto-connect to a Chrome instance (#651) (6ab6d85)
• support --user-data-dir with --auto-connect (#654) (e3c59bc)

🛠️ Fixes

• map channel for resolveDefaultUserDataDir (#658) (6f59b39)

📄 Documentation

• Add AX design principles (#643) (90ed192)
• improve autoConnect docs (#653) (09111cc)

0.11.0 (2025-12-03)

🎉 Features

• emulation: add geolocation emulation tool (#634) (3991e4c)
• integrate DevTools issues into the console tools (#636) (d892145)
• support --user-data-dir (#622) (fcaf553)

🛠️ Fixes

• handle error messages that are not instanceof Error (#618) (a67528a)
• handle the case when all pages are filtered out (#616) (bff5c65)
• ignore hash parts of URLs when finding DevTools (#608) (52533d0)
• ignore quality for png (#589) (2eaf268)
• include a note about selected elements missing from the snapshot (#593) (80e77fd)
• prevent dropping license notices on some files when publishing (#604) (94752ff)
• rename page content to latest page snapshot (#579) (9cb99ad)
• wait_for: respect the provided timeout (#630) (6b0984a), closes #624

📄 Documentation

• add Antigravity config (#580) (6f9182f)
• add Qoder CLI to the MCP client configuration section in the README. (#552) (1a16f15)
• add VS Code install badges (#532) (cc4d065)
• clarify browser-url parameter in README (#613) (05cf8cb)
• Fix Antigravity docs (#605) (fae2608)
• update readme to explain agy's browser integration (#612) (2d89865)

♻️ Chores

• avoid throwing in resolveCdpElementId (#606) (eb261fd)

0.10.2 (2025-11-19)

📄 Documentation

• add Factory CLI configuration to MCP clients (#523) (016e2fd)

♻️ Chores

• clear issue aggregator on page navigation (#565) (c3784d1)
• disable issues in list_console_messages for now (#575) (08e9a9f)
• simplify issue management (#564) (3b016f1)

0.10.1 (2025-11-07)

🛠️ Fixes

• avoid no page selected errors (#537) (4724bbb)

0.10.0 (2025-11-05)

🎉 Features

• add a press_key tool (#458) (b427392)
• add insightSetId to performance_analyze_insight (#518) (36504d2)
• an option to ignore cache on reload (#485) (8e56307)
• detect network requests inspected in DevTools UI (#477) (796aed7)
• fetch DOM node selected in the DevTools Elements panel (#486) (4a83574)
• support page reload (#462) (d177087)
• support saving snapshots to file (#463) (b0ce08a)

🛠️ Fixes

• Augment fix to prevent stray OGS frames in NTP from causing hangs. (#521) (d90abd4)
• improve get_network_request description (#500) (2f448e8)
• work around NTP iframes causing hangs (#504) (cca5ff4)

📄 Documentation

• add Windsurf to the editor config README (#493) (63a5d82)
• fix typos in README.md exlcude -> exclude (#513) (8854a34)
• remove unnecessary replace (#475) (40e1753)

♻️ Chores

• connect to DevTools targets by default (#466) (a41e440)
• detect DevTools page for each page (#467) (1560ff2)
• merge emulate tools into one (#494) (c06f452)

0.9.0 (2025-10-22)

🎉 Features

• add claude marketplace and plugin json (#396) (0498611)
• add filters and pagination to the console messages tool (#387) (15d942c)
• add WebSocket endpoint and custom headers support (#404) (41d6a10)
• allow configuring tool categories (#454) (0fe2b8a)
• expose previous navigations to the MCP (#419) (165cf9c)
• support previous navigation for Console messages (#452) (6f24362)
• support stable id for network requests (#375) (f4d7b49)
• support verbose snapshots (#388) (d47aaa9)
• tool to get a verbose single console message (#435) (9205593)
• use stable id for network request querying (#382) (579819b)

🛠️ Fixes

• allow evaluating in Frames (#443) (053f1f8)
• better wording for evaluate_script (#392) (2313fda)
• indicate when request and response bodies are not available (#446) (7d47d6b)
• pageerror for non-error types (#442) (b6b42ec)
• retrieve data correctly with fewer than 3 navigations (#451) (4c65f59)

📄 Documentation

• add instructions for Qoder (#386) (d8df784)
• add VM-to-host remote debugging workaround (#399) (9f9dab0)
• Update Copilot CLI instructions (#423) (c7733a8)

♻️ Chores

• bundle all dependencies together (#450) (914b980)
• bundle modelcontextprotocol-sdk (#409) (6c8432b)
• bundle puppeteer-core (#417) (b443033)
• bundle zod together with modelcontextprotocol/sdk (#414) (800e7e8)
• cleanup data fetching (#441) (5c871c3)
• dispose listeners on page destroyed (#318) (76d5e94)
• extract common paginate type (#415) (29fd602)
• store the last 3 navigations in PageCollector (#411) (b873822)
• use different format for reqid (#380) (78bf66a)

0.8.1 (2025-10-13)

Bug Fixes

• add an option value to the snapshot (#362) (207137e)
• improve navigate_page_history error messages (#321) (0624029)
• return the default dialog value correctly (#366) (f08f808)
• update puppeteer to 24.24.1 (#370) (477eef4)

0.8.0 (2025-10-10)

Features

• support passing args to Chrome (#338) (e1b5363)

0.7.1 (2025-10-10)

Bug Fixes

• document that console and requests are since the last nav (#335) (9ad7cbb)

0.7.0 (2025-10-10)

Features

• Add offline network emulation support to emulate_network command (#326) (139ce60)
• add request and response body (#267) (dd3c143)

Bug Fixes

• ordering of information in performance trace summary (#334) (2d4484a)
• publishing to MCP registry (#313) (1faec78)
• use default ProtocolTimeout (#315) (a525f19)

0.6.1 (2025-10-07)

Bug Fixes

• change default screen size in headless (#299) (357db65)
• cli: tolerate empty browser URLs (#298) (098a904)
• guard performance_stop_trace when tracing inactive (#295) (8200194)

0.6.0 (2025-10-01)

Features

• screenshot: add WebP format support with quality parameter (#220) (03e02a2)
• screenshot: adds ability to output screenshot to a specific pat… (#172) (f030726)
• support --accept-insecure-certs CLI (#231) (efb106d)
• support --proxy-server CLI (#230) (dfacc75)
• support initial viewport in the CLI (#229) (ef61a08)
• support timeouts in wait_for and navigations (#228) (36e64d5)

Bug Fixes

• network: show only selected request (#236) (73f0aec)
• PageCollector subscribing multiple times (#241) (0412878)
• snapshot does not capture Iframe content (#217) (ce356f2), closes #186

0.5.1 (2025-09-29)

Bug Fixes

• update package.json engines to reflect node20 support (#210) (b31e647)

0.5.0 (2025-09-29)

Features

• screenshot: add JPEG quality parameter support (#184) (139cfd1)

Bug Fixes

• do not error if the dialog was already handled (#208) (d9f77f8)
• reference to handle_dialog tool (#209) (205eef5)
• support node20 (#52) (13613b4)
• update tool reference in an error (#205) (7765bb3)

0.4.0 (2025-09-26)

Features

• add network request filtering by resource type (#162) (59d81a3)

Bug Fixes

• add core web vitals to performance_start_trace description (#168) (6cfc977)
• add data format information to trace summary (#166) (869dd42)
• expose --debug-file argument (#164) (22ec7ee)
• typo in the disclaimers (#156) (90f686e)

0.3.0 (2025-09-25)

Features

• Add pagination list_network_requests (#145) (4c909bb)

Bug Fixes

• avoid reporting page close errors as errors (#127) (44cfc8f)
• clarify the node version message (#135) (0cc907a)
• do not set channel if executablePath is provided (#150) (03b59f0)
• performance: ImageDelivery insight errors (#144) (d64ba0d)
• roll latest DevTools to handle Insight errors (#149) (b2e1e39)

0.2.7 (2025-09-24)

Bug Fixes

• validate and report incompatible Node versions (#113) (adfcecf)

0.2.6 (2025-09-24)

Bug Fixes

• manually bump server.json versions based on package.json (#105) (cae1cf1)

0.2.5 (2025-09-24)

Bug Fixes

• add mcpName to package.json (#103) (bd0351f)

0.2.4 (2025-09-24)

Bug Fixes

• forbid closing the last page (#90) (0ca2434)

0.2.3 (2025-09-24)

Bug Fixes

• add a message indicating that no console messages exist (#91) (1a4ba4d)
• clean up pending promises on action errors (#84) (4e7001a)

0.2.2 (2025-09-23)

Bug Fixes

• cli version being reported as unknown (#74) (d6bab91)
• remove unnecessary waiting for navigation (#83) (924c042)
• rework performance parsing & error handling (#75) (e8fb30c)

0.2.1 (2025-09-23)

Bug Fixes

• add 'on the selected page' to performance tools (#69) (b877f7a)
• emulation: correctly report info for selected page (#63) (1e8662f)
• expose timeout when Emulation is enabled (#73) (0208bfd)
• fix browserUrl not working (#53) (a6923b8)
• increase timeouts in case of Emulation (#71) (c509c64)
• windows: work around Chrome not reporting reasons for crash (#64) (d545741)

0.2.0 (2025-09-17)

Features

• add performance_analyze_insight tool. (#42) (21e175b)
• support script evaluate arguments (#40) (c663f4d)
• use Performance Trace Formatter in trace output (#36) (0cb6147)
• validate uids (#37) (014a8bc)

Bug Fixes

• change profile folder name to browser-profile (#39) (36115d7)
• refresh context based on the browser instance (#44) (93f4579)
• update puppeteer to fix a11y snapshot issues (#43) (b58f787)

0.1.0 (2025-09-16)

Features

• improve tools with awaiting common events (#10) (dba8b3c)
• initial version (31a0bdc)

Bug Fixes

• define tracing categories (#21) (c939456)
• detect multiple instances and throw (#12) (732267d)
• make sure tool calls are processed sequentially (#22) (a76b23d)