/CHANGELOG.md

Changelog

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)