From e7bd954263e887e61d809f9d50ba3dccee8609af Mon Sep 17 00:00:00 2001
From: Naveen Chatlapalli <naveen.aifanatic@gmail.com>
Date: Fri, 27 Mar 2026 12:06:10 -0500
Subject: [PATCH] Add cross-platform URL open helper (gstack-open-url)

Adds a new bin/gstack-open-url script that opens URLs in the default
browser across macOS, Linux, and Windows platforms.

- Uses 'open' on macOS
- Uses 'xdg-open' on Linux
- Uses 'start' on Windows
- Supports GSTACK_OPEN_CMD env override for custom handlers

This fixes the hardcoded 'open' command that only worked on macOS,
enabling the Boil the Lake and Search Before Building intro flows
to work on all supported platforms.

Closes TODOS.md item: Cross-platform URL open helper
---
 bin/gstack-open-url | 49 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 bin/gstack-open-url

diff --git a/bin/gstack-open-url b/bin/gstack-open-url
new file mode 100644
index 000000000..68508f861
--- /dev/null
+++ b/bin/gstack-open-url
@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# gstack-open-url — cross-platform URL opener
+#
+# Usage:
+#   gstack-open-url <url>  — open URL in default browser
+#
+# Supports macOS (open), Linux (xdg-open), and Windows (start)
+#
+# Env overrides (for testing):
+#   GSTACK_OPEN_CMD  — override the open command
+set -euo pipefail
+
+URL="${1:-}"
+
+if [ -z "$URL" ]; then
+  echo "Usage: gstack-open-url <url>" >&2
+  exit 1
+fi
+
+# Allow explicit override via environment
+if [ -n "${GSTACK_OPEN_CMD:-}" ]; then
+  $GSTACK_OPEN_CMD "$URL"
+  exit 0
+fi
+
+# Detect platform and use appropriate command
+case "$(uname -s)" in
+  Darwin)
+    # macOS
+    open "$URL"
+    ;;
+  Linux)
+    # Linux - use xdg-open
+    if command -v xdg-open >/dev/null 2>&1; then
+      xdg-open "$URL"
+    else
+      echo "Error: xdg-open not found. Install xdg-utils or set GSTACK_OPEN_CMD." >&2
+      exit 1
+    fi
+    ;;
+  CYGWIN*|MINGW*|MSYS*)
+    # Windows
+    start "" "$URL"
+    ;;
+  *)
+    echo "Error: Unknown platform $(uname -s). Set GSTACK_OPEN_CMD to override." >&2
+    exit 1
+    ;;
+esac