@dbalabka/chrome-wsl 0.2.7 → 0.3.1

package/README.md

@@ -29,6 +29,10 @@ npx @dbalabka/chrome-wsl
 ```sh
  npx @dbalabka/chrome-wsl --stop
 ```
+- To uninstall (prompts before removing the firewall rule and socat):
+```sh
+ npx @dbalabka/chrome-wsl --uninstall
+```
 - Runs directly via npm without cloning; default entrypoint is `chrome-wsl` (matching the package name).
 
 #### Example
@@ -57,6 +61,7 @@ Then run:
   ```sh
   chrome-wsl
   chrome-wsl --stop
+  chrome-wsl --uninstall
   ```
 
 ## Notes
@@ -64,5 +69,19 @@ Then run:
 - 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`.
 
+## Chrome DevTools MCP configuration for agents
+
+To use Windows Chrome with any agent running in WSL you have 
+to cofigure the DevTools to connect to `--browser-url=http://127.0.0.1:9222`.
+
+### Codex
+
+```toml
+[mcp_servers.chome-devtools]
+command = "npx"
+args = ["-y", "chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]
+startup_timeout_sec = 20.0
+```
+
 ## License
 MIT License. See `LICENSE` for details.

package/chrome-wsl

@@ -64,8 +64,37 @@ stop_socat() {
 }
 
 run_powershell() {
-  # Runs a PowerShell command from WSL.
-  powershell.exe -NoLogo -NoProfile -NonInteractive -Command "$@"
+  # Runs a PowerShell command from WSL. If RUN_AS_ADMIN=1, invoke via Start-Process -Verb RunAs
+  # and capture output through a temp script/output file to mirror direct execution.
+  local ps_cmd="$*"
+
+  if [[ "${RUN_AS_ADMIN:-}" == "1" ]]; then
+    local out_file ps_file win_out win_ps
+    mkdir -p /mnt/c/Temp
+    out_file=$(mktemp -p /mnt/c/Temp chrome-wsl-out-XXXXXX)
+    ps_file=$(mktemp -p /mnt/c/Temp --suffix=.ps1 chrome-wsl-XXXXXX)
+    win_out=$(wslpath -w "$out_file")
+    win_ps=$(wslpath -w "$ps_file")
+
+    {
+      echo "& {"
+      echo "  ${ps_cmd}"
+      echo "} | Out-File -FilePath \"${win_out}\" -Encoding UTF8"
+    } >"$ps_file"
+
+    powershell.exe -NoLogo -NoProfile -NonInteractive -Command "Start-Process -FilePath 'powershell' -Verb RunAs -ArgumentList '-NoLogo','-NoProfile','-NonInteractive','-File','\"${win_ps}\"' -WindowStyle Hidden -Wait"
+    cat "$out_file"
+    rm -f "$out_file" "$ps_file"
+  else
+    powershell.exe -NoLogo -NoProfile -NonInteractive -Command "$ps_cmd"
+  fi
+}
+
+confirm() {
+  local prompt=$1
+  local reply
+  read -r -p "${prompt} [y/N] " reply
+  [[ "${reply}" =~ ^[Yy]$ ]]
 }
 
 chrome_running() {
@@ -89,6 +118,10 @@ 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_wsl_host_ip() {
   local host_ip
   host_ip=$(ip route | awk '/^default via / {print $3; exit}')
@@ -118,19 +151,68 @@ EOF
 }
 
 check_firewall_rule() {
-  if run_powershell "\$rule='${FIREWALL_RULE_NAME}'; if (Get-NetFirewallRule -DisplayName \$rule -ErrorAction SilentlyContinue) { exit 0 } else { exit 1 }"; then
+  local rule_check_cmd="\$rule='${FIREWALL_RULE_NAME}'; if (Get-NetFirewallRule -DisplayName \$rule -ErrorAction SilentlyContinue) { exit 0 } else { exit 1 }"
+
+  if run_powershell "${rule_check_cmd}"; then
     ok "Firewall rule \"${FIREWALL_RULE_NAME}\" exists."
     return 0
   fi
 
+  err "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}\"."
+    return 0
+  fi
+
   cat <<EOF
-${ERR_MARK} Firewall rule "${FIREWALL_RULE_NAME}" is missing.
+${ERR_MARK} Failed to create firewall rule "${FIREWALL_RULE_NAME}" automatically.
 Run this in an **admin PowerShell** window:
 New-NetFirewallRule -DisplayName "${FIREWALL_RULE_NAME}" -Direction Inbound -LocalPort ${PORT} -Protocol TCP -Action Allow
 EOF
   return 1
 }
 
+uninstall_firewall_rule() {
+  local rule_check_cmd="\$rule='${FIREWALL_RULE_NAME}'; if (Get-NetFirewallRule -DisplayName \$rule -ErrorAction SilentlyContinue) { exit 0 } else { exit 1 }"
+
+  if ! run_powershell "${rule_check_cmd}"; then
+    ok "Firewall rule \"${FIREWALL_RULE_NAME}\" is already absent."
+    return 0
+  fi
+
+  if ! confirm "Remove firewall rule \"${FIREWALL_RULE_NAME}\"?"; then
+    ok "Skipped firewall rule removal."
+    return 0
+  fi
+
+  if RUN_AS_ADMIN=1 run_powershell "Remove-NetFirewallRule -DisplayName \"${FIREWALL_RULE_NAME}\"" \
+     && ! run_powershell "${rule_check_cmd}"; then
+    ok "Removed firewall rule \"${FIREWALL_RULE_NAME}\"."
+  else
+    err "Failed to remove firewall rule \"${FIREWALL_RULE_NAME}\"."
+  fi
+}
+
+uninstall_socat() {
+  if ! command -v socat >/dev/null 2>&1; then
+    ok "socat is not installed; nothing to remove."
+    return 0
+  fi
+
+  if ! confirm "Remove socat package (sudo apt-get remove -y socat)?"; then
+    ok "Skipped socat removal."
+    return 0
+  fi
+
+  stop_socat
+  if sudo apt-get remove -y socat; then
+    ok "Removed socat package."
+  else
+    err "Failed to remove socat package."
+  fi
+}
+
 ensure_socat() {
   if command -v socat >/dev/null 2>&1; then
     ok "socat is already installed."
@@ -185,6 +267,11 @@ 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
@@ -203,6 +290,12 @@ start_chrome() {
 }
 
 main() {
+  if [[ "${1-}" == "--uninstall" ]]; then
+    uninstall_firewall_rule
+    uninstall_socat
+    exit 0
+  fi
+
   if [[ "${1-}" == "--stop" ]]; then
     stop_chrome
     stop_socat

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dbalabka/chrome-wsl",
-  "version": "0.2.7",
+  "version": "0.3.1",
   "description": "WSL helper to start Windows Chrome with remote debugging and socat port forwarding.",
   "bin": "./chrome-wsl",
   "files": [