@dbalabka/chrome-wsl 0.3.1 → 0.4.0

package/README.md

@@ -16,6 +16,7 @@ A small WSL helper to open Google Chrome on Windows with remote debugging (port
 - WSL with `powershell.exe` available.
 - Windows Chrome installed at `C:\Program Files\Google\Chrome\Application\chrome.exe` (adjust the path in the script if different).
 - Network/apt access to install `socat` on first run (or preinstall manually).
+- Run the script from inside WSL; non-WSL Linux is not supported (Docker has limited proxy-only support, see below).
 
 ## Usage
 
@@ -64,10 +65,14 @@ Then run:
   chrome-wsl --uninstall
   ```
 
-## Notes
-- Portproxy check expects forwarding from the detected Windows host IP to `127.0.0.1:9222`.
-- Chrome launch is skipped when port 9222 already listens on Windows (assumed active remote-debug session).
-- For a different remote debugging port or Chrome path, edit `PORT` or `WINDOWS_CHROME_PATH` in `start_chrome_wsl.sh`.
+## Docker
+
+`chrome-wsl` can also take care of starting a proxy inside the Docker container and allow to access the MCP server from localhost. It helps to use the same Chrome DevTools MCP configuration for agents running inside the docker container as well as outside.
+```shell
+npx @dbalabka/chrome-wsl --container=<name>
+npx @dbalabka/chrome-wsl --stop --container=<name>
+npx @dbalabka/chrome-wsl --uninstall --container=<name>
+```
 
 ## Chrome DevTools MCP configuration for agents
 
@@ -83,5 +88,13 @@ args = ["-y", "chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222
 startup_timeout_sec = 20.0
 ```
 
+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:
+    app:
+        volumes:
+            - ~/.codex:/home/vscode/.codex
+```
+
 ## License
 MIT License. See `LICENSE` for details.

package/chrome-wsl

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # Compatible with bash and zsh.
+PACKAGE_VERSION="0.4.0"
 set -e
 set -u
 if command -v setopt >/dev/null 2>&1; then
@@ -12,15 +13,25 @@ PORT=9222
 WINDOWS_CHROME_PATH='C:\Program Files\Google\Chrome\Application\chrome.exe'
 FIREWALL_RULE_NAME='Chrome Remote Debug'
 PID_FILE="/tmp/start-chrome-wsl.pids"
+HOST_IP=""
+BROWSER_VERSION=""
 OK_MARK="✅"
+WARN_MARK="❗"
 ERR_MARK="❌"
 
 ok() {
-  echo "${OK_MARK} $*"
+  local prefix="${CONTAINER_LABEL:+[${CONTAINER_LABEL}] }"
+  echo "${OK_MARK} ${prefix}$*"
 }
 
 err() {
-  echo "${ERR_MARK} $*" >&2
+  local prefix="${CONTAINER_LABEL:+[${CONTAINER_LABEL}] }"
+  echo "${ERR_MARK} ${prefix}$*" >&2
+}
+
+warn() {
+  local prefix="${CONTAINER_LABEL:+[${CONTAINER_LABEL}] }"
+  echo "${WARN_MARK} ${prefix}$*" >&2
 }
 
 set_pid() {
@@ -90,13 +101,21 @@ run_powershell() {
   fi
 }
 
+CONFIRM_MARK="❔"
 confirm() {
   local prompt=$1
   local reply
-  read -r -p "${prompt} [y/N] " reply
+  local prefix="${CONTAINER_LABEL:+[${CONTAINER_LABEL}] }"
+  read -r -p "${CONFIRM_MARK} ${prefix}${prompt} [y/N] " reply
   [[ "${reply}" =~ ^[Yy]$ ]]
 }
 
+version_suffix() {
+  if [[ -n "${BROWSER_VERSION:-}" ]]; then
+    printf " (Chrome %s)" "$BROWSER_VERSION"
+  fi
+}
+
 chrome_running() {
   run_powershell "if (Get-Process -Name chrome -ErrorAction SilentlyContinue) { exit 0 } else { exit 1 }"
 }
@@ -118,8 +137,12 @@ port_listening_info() {
   run_powershell "\$conns = Get-NetTCPConnection -LocalPort ${PORT} -ErrorAction SilentlyContinue | Select-Object -Property LocalAddress,LocalPort,RemoteAddress,RemotePort,State,OwningProcess; foreach (\$c in \$conns) { \$p = Get-Process -Id \$c.OwningProcess -ErrorAction SilentlyContinue; \$name = if (\$p) { \$p.Name } else { 'unknown' }; Write-Output (\"{0}:{1} owner={2} pid={3} state={4}\" -f \$c.LocalAddress, \$c.LocalPort, \$name, \$c.OwningProcess, \$c.State) }"
 }
 
-port_in_use_by_non_chrome() {
-  run_powershell "if (Get-NetTCPConnection -LocalPort ${PORT} -ErrorAction SilentlyContinue | Where-Object { \$p = Get-Process -Id \_.OwningProcess -ErrorAction SilentlyContinue; -not (\$p -and \$p.Name -eq 'chrome') }) { exit 0 } else { exit 1 }"
+get_browser_version() {
+  local host_ip=${1:-$HOST_IP}
+  [[ -z "${host_ip:-}" ]] && return 0
+  curl -s "http://${host_ip}:${PORT}/json/version" \
+    | sed -n "s/.*\"Browser\"[[:space:]]*:[[:space:]]*\"\\([^\"]*\\)\".*/\\1/p" \
+    | head -n 1
 }
 
 get_wsl_host_ip() {
@@ -135,13 +158,24 @@ get_wsl_host_ip() {
 check_portproxy() {
   local host_ip=$1
   local output regex
-  output=$(run_powershell "netsh interface portproxy show all" | tr -d '\r')
-  regex="${host_ip//./\\.}[[:space:]]+${PORT}[[:space:]]+127\\.0\\.0\\.1[[:space:]]+${PORT}"
+  output=$(run_powershell "netsh interface portproxy show all" | tr -d '
+')
+  regex="${host_ip//./\.}[[:space:]]+${PORT}[[:space:]]+127\.0\.0\.1[[:space:]]+${PORT}"
   if echo "$output" | grep -Eq "$regex"; then
     ok "Portproxy ${host_ip}:${PORT} -> 127.0.0.1:${PORT} is configured."
     return 0
   fi
 
+  warn "Portproxy on ${host_ip}:${PORT} is missing; attempting to create it (may prompt for admin)."
+  if RUN_AS_ADMIN=1 run_powershell "netsh interface portproxy add v4tov4 listenaddress=${host_ip} listenport=${PORT} connectaddress=127.0.0.1 connectport=${PORT}"; then
+    output=$(run_powershell "netsh interface portproxy show all" | tr -d '
+')
+    if echo "$output" | grep -Eq "$regex"; then
+      ok "Created portproxy ${host_ip}:${PORT} -> 127.0.0.1:${PORT}."
+      return 0
+    fi
+  fi
+
   cat <<EOF
 ${ERR_MARK} Portproxy on ${host_ip}:${PORT} is missing.
 Run this in an **admin PowerShell** window:
@@ -158,7 +192,7 @@ check_firewall_rule() {
     return 0
   fi
 
-  err "Firewall rule \"${FIREWALL_RULE_NAME}\" is missing; attempting to create it (may prompt for admin)."
+  warn "Firewall rule \"${FIREWALL_RULE_NAME}\" is missing; attempting to create it (may prompt for admin)."
   if RUN_AS_ADMIN=1 run_powershell "New-NetFirewallRule -DisplayName \"${FIREWALL_RULE_NAME}\" -Direction Inbound -LocalPort ${PORT} -Protocol TCP -Action Allow" \
      && run_powershell "${rule_check_cmd}"; then
     ok "Created firewall rule \"${FIREWALL_RULE_NAME}\"."
@@ -213,13 +247,40 @@ uninstall_socat() {
   fi
 }
 
+# Remove portproxy entry
+uninstall_portproxy() {
+  local host_ip=${1:-$HOST_IP}
+  if [[ -z "${host_ip:-}" ]]; then
+    host_ip=$(get_wsl_host_ip)
+  fi
+  local output regex
+  output=$(run_powershell "netsh interface portproxy show all" | tr -d '\r')
+  regex="${host_ip//./\\.}[[:space:]]+${PORT}[[:space:]]+127\\.0\\.0\\.1[[:space:]]+${PORT}"
+  if ! echo "$output" | grep -Eq "$regex"; then
+    ok "Portproxy ${host_ip}:${PORT} is already absent."
+    return 0
+  fi
+
+  if ! confirm "Remove portproxy ${host_ip}:${PORT} -> 127.0.0.1:${PORT}?"; then
+    ok "Skipped portproxy removal."
+    return 0
+  fi
+
+  if RUN_AS_ADMIN=1 run_powershell "netsh interface portproxy delete v4tov4 listenaddress=${host_ip} listenport=${PORT}" \
+     && ! (run_powershell "netsh interface portproxy show all" | tr -d '\r' | grep -Eq "$regex"); then
+    ok "Removed portproxy ${host_ip}:${PORT} -> 127.0.0.1:${PORT}."
+  else
+    err "Failed to remove portproxy ${host_ip}:${PORT}."
+  fi
+}
+
 ensure_socat() {
   if command -v socat >/dev/null 2>&1; then
     ok "socat is already installed."
     return 0
   fi
 
-  err "socat not found. Installing via apt..."
+  warn "socat not found. Installing via apt..."
   sudo apt-get update
   sudo apt-get install -y socat
 }
@@ -236,6 +297,40 @@ start_socat() {
   ok "Started socat (logging to /tmp/socat-9222.log)."
 }
 
+is_docker() {
+  [[ -f /.dockerenv ]] && return 0
+  grep -qaE 'docker|containerd|kubepods' /proc/1/cgroup 2>/dev/null
+}
+
+container_exec() {
+  local container=$1; shift
+  local script_path
+  script_path=$(readlink -f "$0")
+  ensure_docker
+  local tty_flag="-i"
+  if [ -t 0 ]; then
+    tty_flag="-it"
+  fi
+  if ! cat "$script_path" | docker exec -i "${container}" sh -c "cat > /tmp/chrome-wsl.sh"; then
+    err "Failed to copy script into container ${container}."
+    exit 1
+  fi
+  local inner_cmd="CONTAINER_LABEL=${container} chmod +x /tmp/chrome-wsl.sh && CONTAINER_LABEL=${container} /tmp/chrome-wsl.sh $*"
+  docker exec ${tty_flag} "${container}" sh -lc "${inner_cmd}"
+}
+
+get_docker_host_ip() {
+  getent hosts host.docker.internal 2>/dev/null | awk '{print $1; exit}'
+}
+
+ensure_docker() {
+  if command -v docker >/dev/null 2>&1; then
+    return 0
+  fi
+  err "Docker CLI is required for --container."
+  exit 1
+}
+
 stop_chrome() {
   local chrome_pid
   chrome_pid=$(get_pid "CHROME_PID")
@@ -267,11 +362,6 @@ start_chrome() {
     fi
   fi
 
-  if port_in_use_by_non_chrome; then
-    err "Port ${PORT} is already in use by another process (not Chrome); details:"
-    port_listening_info
-  fi
-
   local chrome_pid
   chrome_pid=$(run_powershell "$chrome_cmd" | tr -d '\r' | head -n 1)
   if [[ -n "${chrome_pid:-}" ]]; then
@@ -289,21 +379,79 @@ start_chrome() {
   fi
 }
 
+ensure_wsl() {
+  if grep -qEi 'Microsoft|WSL' /proc/version >/dev/null 2>&1; then
+    return 0
+  fi
+  err "This tool must be run inside WSL; exiting."
+  exit 1
+}
+
 main() {
-  if [[ "${1-}" == "--uninstall" ]]; then
+  local container="" uninstall_flag=0 stop_flag=0
+  for arg in "$@"; do
+    case "$arg" in
+      --container=*) container=${arg#*=} ;;
+      --uninstall) uninstall_flag=1 ;;
+      --stop) stop_flag=1 ;;
+    esac
+  done
+
+  if [[ "${1-}" == "--version" || "${1-}" == "-V" ]]; then
+    echo "chrome-wsl ${PACKAGE_VERSION:-unknown}"
+    exit 0
+  fi
+
+  if is_docker && [[ -n "$container" ]]; then
+    err "--container is only supported when running in WSL, not inside Docker."
+    exit 1
+  fi
+
+  if is_docker; then
+    if [[ $uninstall_flag -eq 1 ]]; then
+      uninstall_socat
+      exit 0
+    fi
+
+    if [[ $stop_flag -eq 1 ]]; then
+      stop_socat
+      exit 0
+    fi
+
+    HOST_IP=$(get_docker_host_ip)
+    if [[ -z "${HOST_IP:-}" ]]; then
+      err "Could not resolve host.docker.internal inside Docker."
+      exit 1
+    fi
+
+    ensure_socat
+    start_socat "$HOST_IP"
+    exit 0
+  fi
+
+  ensure_wsl
+
+  if [[ $uninstall_flag -eq 1 ]]; then
+    uninstall_portproxy
     uninstall_firewall_rule
     uninstall_socat
+    if [[ -n "$container" ]]; then
+      container_exec "$container" --uninstall
+    fi
     exit 0
   fi
 
-  if [[ "${1-}" == "--stop" ]]; then
+  if [[ $stop_flag -eq 1 ]]; then
     stop_chrome
     stop_socat
+    if [[ -n "$container" ]]; then
+      container_exec "$container" --stop
+    fi
     exit 0
   fi
 
-  local host_ip
-  host_ip=$(get_wsl_host_ip)
+  HOST_IP=$(get_wsl_host_ip)
+  local host_ip="$HOST_IP"
   ok "Detected Windows host IP: ${host_ip}"
 
   check_portproxy "$host_ip" || exit 1
@@ -311,6 +459,10 @@ main() {
   ensure_socat
   start_socat "$host_ip"
   start_chrome
+
+  if [[ -n "$container" ]]; then
+    container_exec "$container"
+  fi
 }
 
-main "$@"
+main "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dbalabka/chrome-wsl",
-  "version": "0.3.1",
+  "version": "0.4.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"
   }
-}
+}