@dbalabka/chrome-wsl 0.5.1 → 0.6.0

package/README.md

@@ -33,6 +33,10 @@ npx @dbalabka/chrome-wsl
 ```
 - If portproxy/firewall entries are missing, run the printed admin PowerShell commands on Windows, then rerun the script.
 - The script logs `socat` output to `/tmp/socat-9222.log`.
+- To run Chrome in headless mode (no visible window, requires Chrome 112+):
+```sh
+npx @dbalabka/chrome-wsl --headless
+```
 - To stop the `socat` forwarder:
 ```sh
  npx @dbalabka/chrome-wsl --stop
@@ -70,6 +74,7 @@ To install globally instead of npx:
 Then run:
   ```sh
   chrome-wsl
+  chrome-wsl --headless
   chrome-wsl --stop
   chrome-wsl --uninstall
   ```
@@ -90,6 +95,7 @@ to cofigure the DevTools to connect to `--browser-url=http://127.0.0.1:9222`.
 
 ### Codex
 
+Configuration of [Chrome DevTools](https://github.com/ChromeDevTools/chrome-devtools-mcp):
 ```toml
 [mcp_servers.chome-devtools]
 command = "npx"
@@ -97,6 +103,13 @@ args = ["-y", "chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222
 startup_timeout_sec = 20.0
 ```
 
+Configuratio of [Playwrite](https://github.com/microsoft/playwright-mcp):
+```toml
+[mcp_servers.playwright]
+command = "npx"
+args = ["@playwright/mcp@latest", "--browser=chrome", "--isolated", "--cdp-endpoint=http://127.0.0.1:9222"]
+```
+
 To run Codex inside the container and use the same MCP configuration and authorisation token, mount the Codex configuration folder inside the docker container using the following docker composer settings:
 ```shell
 services:

package/chrome-wsl

@@ -459,8 +459,13 @@ stop_chrome() {
 }
 
 start_chrome() {
+  local headless_mode="${1:-0}"
+  local headless_args=""
+  if [[ "$headless_mode" -eq 1 ]]; then
+    headless_args=", \"--headless=new\""
+  fi
   local chrome_cmd
-  chrome_cmd="\$args = @(\"--remote-debugging-port=${PORT}\", \"--no-first-run\", \"--no-default-browser-check\", \"--user-data-dir=\$env:TEMP\\chrome-profile-stable\"); \$p = Start-Process -FilePath \"${WINDOWS_CHROME_PATH}\" -ArgumentList \$args -PassThru; Write-Output \$p.Id"
+  chrome_cmd="\$args = @(\"--remote-debugging-port=${PORT}\", \"--no-first-run\", \"--no-default-browser-check\", \"--user-data-dir=\$env:TEMP\\chrome-profile-stable\"${headless_args}); \$p = Start-Process -FilePath \"${WINDOWS_CHROME_PATH}\" -ArgumentList \$args -PassThru; Write-Output \$p.Id"
 
   if [[ -n "$(get_pid "CHROME_PID")" ]]; then
     if port_listening_by_chrome; then
@@ -499,13 +504,14 @@ ensure_wsl() {
 }
 
 main() {
-  local container="" uninstall_flag=0 stop_flag=0 debug_flag=0
+  local container="" uninstall_flag=0 stop_flag=0 debug_flag=0 headless_flag=0
   for arg in "$@"; do
     case "$arg" in
       --container=*) container=${arg#*=} ;;
       --uninstall) uninstall_flag=1 ;;
       --stop) stop_flag=1 ;;
       --debug) debug_flag=1 ;;
+      --headless) headless_flag=1 ;;
     esac
   done
 
@@ -584,7 +590,7 @@ main() {
 
   check_portproxy "$host_ip" || exit 1
   check_firewall_rule || exit 1
-  start_chrome
+  start_chrome "$headless_flag"
   ensure_socat
   start_socat "$host_ip"
   check_devtools_access_wsl || true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dbalabka/chrome-wsl",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "WSL helper to start Windows Chrome with remote debugging and socat port forwarding.",
   "bin": "./chrome-wsl",
   "files": [
@@ -28,4 +28,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}