Merge branch 'main' into main

Author: mithun50

.github/ISSUE_TEMPLATE/01-bug.yml

@@ -0,0 +1,73 @@
+name: Bug report
+description: File a bug report for chrome-devtools-mcp
+title: '<short description of the bug>'
+labels:
+  - 'bug'
+body:
+  - id: description
+    type: textarea
+    attributes:
+      label: Description of the bug
+      description: >
+        A clear and concise description of what the bug is.
+      placeholder:
+    validations:
+      required: true
+
+  - id: reproduce
+    type: textarea
+    attributes:
+      label: Reproduction
+      description: >
+        Steps to reproduce the behavior:
+      placeholder: |
+        1. Use tool '...'
+        2. Then use tool '...'
+
+  - id: expectation
+    type: textarea
+    attributes:
+      label: Expectation
+      description: A clear and concise description of what you expected to happen.
+
+  - id: mcp-configuration
+    type: textarea
+    attributes:
+      label: MCP configuration
+
+  - id: node-version
+    type: input
+    attributes:
+      label: Node version
+      description: >
+        Please verify you have the minimal supported version listed in the README.md
+
+  - id: chrome-version
+    type: input
+    attributes:
+      label: Chrome version
+
+  - id: coding-agent-version
+    type: input
+    attributes:
+      label: Coding agent version
+
+  - id: model-version
+    type: input
+    attributes:
+      label: Model version
+
+  - id: chat-log
+    type: input
+    attributes:
+      label: Chat log
+
+  - id: operating-system
+    type: dropdown
+    attributes:
+      label: Operating system
+      description: What supported operating system are you running?
+      options:
+        - Windows
+        - macOS
+        - Linux

.github/ISSUE_TEMPLATE/bug_report.md

@@ -10,12 +10,19 @@ updates:
     groups:
       dependencies:
         dependency-type: production
+        exclude-patterns:
+          - 'puppeteer*'
         patterns:
           - '*'
       dev-dependencies:
         dependency-type: development
+        exclude-patterns:
+          - 'puppeteer*'
         patterns:
           - '*'
+      puppeteer:
+        patterns:
+          - 'puppeteer*'
   - package-ecosystem: github-actions
     directory: /
     schedule:

.github/dependabot.yml

@@ -0,0 +1,24 @@
+name: 'Conventional Commit'
+
+on:
+  pull_request_target:
+    types:
+      # Defaults
+      # https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#pull_request_target
+      - opened
+      - reopened
+      - synchronize
+      # Tracks editing PR title or description, or base branch changes
+      # https://docs.github.com/en/webhooks/webhook-events-and-payloads?actionType=edited#pull_request
+      - edited
+
+jobs:
+  main:
+    name: '[Required] Validate PR title'
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    steps:
+      - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/convetional-commit.yml

@@ -10,6 +10,7 @@ on:
 
 jobs:
   check-format:
+    name: '[Required] Check correct format'
     runs-on: ubuntu-latest
 
     steps:
@@ -31,6 +32,7 @@ jobs:
         run: npm run check-format
 
   check-docs:
+    name: '[Required] Check docs updated'
     runs-on: ubuntu-latest
 
     steps:

.github/workflows/presubmit.yml

@@ -4,6 +4,16 @@ on:
   push:
     tags:
       - 'chrome-devtools-mcp-v*'
+  workflow_dispatch:
+    inputs:
+      npm-publish:
+        description: 'Try to publish to NPM'
+        default: false
+        type: boolean
+      mcp-publish:
+        description: 'Try to publish to MCP registry'
+        default: true
+        type: boolean
 
 permissions:
   id-token: write # Required for OIDC
@@ -12,6 +22,7 @@ permissions:
 jobs:
   publish-to-npm:
     runs-on: ubuntu-latest
+    if: ${{ (github.event_name != 'workflow_dispatch') || (inputs.npm-publish && always()) }}
     steps:
       - name: Check out repository
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
@@ -42,6 +53,7 @@ jobs:
   publish-to-mcp-registry:
     runs-on: ubuntu-latest
     needs: publish-to-npm
+    if: ${{ (github.event_name != 'workflow_dispatch' && needs.publish-to-npm.result == 'success') || (inputs.mcp-publish && always()) }}
     steps:
       - name: Check out repository
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
@@ -70,7 +82,9 @@ jobs:
 
       - name: Install MCP Publisher
         run: |
-          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+          export VERSION="1.2.1"
+          export OS=$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v${VERSION}/mcp-publisher_${VERSION}_${OS}.tar.gz" | tar xz mcp-publisher
 
       - name: Login to MCP Registry
         run: ./mcp-publisher login github-oidc

.github/workflows/publish-to-npm-on-tag.yml

@@ -1,3 +1,3 @@
 {
-  ".": "0.6.0"
+  ".": "0.6.1"
 }

.release-please-manifest.json

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.6.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.6.0...chrome-devtools-mcp-v0.6.1) (2025-10-07)
+
+
+### Bug Fixes
+
+* change default screen size in headless ([#299](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/299)) ([357db65](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/357db65d18f87b1299a0f6212b7ec982ef187171))
+* **cli:** tolerate empty browser URLs ([#298](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/298)) ([098a904](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/098a904b363f3ad81595ed58c25d34dd7d82bcd8))
+* guard performance_stop_trace when tracing inactive ([#295](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/295)) ([8200194](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/8200194c8037cc30b8ab815e5ee0d0b2b000bea6))
+
 ## [0.6.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.5.1...chrome-devtools-mcp-v0.6.0) (2025-10-01)
 
 

CHANGELOG.md

@@ -29,7 +29,7 @@ MCP clients.
 
 ## Requirements
 
-- [Node.js 20](https://nodejs.org/) or a newer [latest maintainance LTS](https://github.com/nodejs/Release#release-schedule) version.
+- [Node.js](https://nodejs.org/) v20.19 or a newer [latest maintenance LTS](https://github.com/nodejs/Release#release-schedule) version.
 - [Chrome](https://www.google.com/chrome/) current stable version or newer.
 - [npm](https://www.npmjs.com/).
 
@@ -111,7 +111,7 @@ Start the dialog to add a new MCP server by running:
 /mcp add
 ```
 
-Configure the following fields and press `CTR-S` to save the configuration:
+Configure the following fields and press `CTRL+S` to save the configuration:
 
 - **Server name:** `chrome-devtools`
 - **Server Type:** `[1] Local`
@@ -185,6 +185,13 @@ The same way chrome-devtools-mcp can be configured for JetBrains Junie in `Setti
   [<img src="https://img.shields.io/badge/Visual_Studio-Install-C16FDE?logo=visualstudio&logoColor=white" alt="Install in Visual Studio">](https://vs-open.link/mcp-install?%7B%22name%22%3A%22chrome-devtools%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22chrome-devtools-mcp%40latest%22%5D%7D)
 </details>
 
+<details>
+  <summary>Warp</summary>
+
+Go to `Settings | AI | Manage MCP Servers` -> `+ Add` to [add an MCP Server](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server). Use the config provided above.
+
+</details>
+
 ### Your first prompt
 
 Enter the following prompt in your MCP Client to check if everything is working:
@@ -273,7 +280,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** string
 
 - **`--viewport`**
-  Initial viewport size for the Chromee instances started by the server. For example, `1280x720`
+  Initial viewport size for the Chrome instances started by the server. For example, `1280x720`. In headless mode, max size is 3840x2160px.
   - **Type:** string
 
 - **`--proxyServer`**
@@ -313,7 +320,7 @@ You can also run `npx chrome-devtools-mcp@latest --help` to see all available co
 `chrome-devtools-mcp` starts a Chrome's stable channel instance using the following user
 data directory:
 
-- Linux / MacOS: `$HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL`
+- Linux / macOS: `$HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL`
 - Windows: `%HOMEPATH%/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL`
 
 The user data directory is not cleared between runs and shared across

README.md

@@ -223,7 +223,7 @@
 
 ### `performance_analyze_insight`
 
-**Description:** Provides more detailed information on a specific Performance Insight that was highlighed in the results of a trace recording.
+**Description:** Provides more detailed information on a specific Performance Insight that was highlighted in the results of a trace recording.
 
 **Parameters:**