Improve Windows installation experience

Author: robzolkos

README.md

@@ -9,10 +9,25 @@
 
 ## Quick Start
 
+**macOS / Linux / WSL / Git Bash**
+
 ```bash
 curl -fsSL https://basecamp.com/install-cli | bash
 ```
 
+**Windows (PowerShell)**
+
+```powershell
+irm https://raw.githubusercontent.com/basecamp/basecamp-cli/main/scripts/install.ps1 | iex
+```
+
+**Windows (Scoop)**
+
+```powershell
+scoop bucket add basecamp https://github.com/basecamp/homebrew-tap
+scoop install basecamp-cli
+```
+
 That's it. You now have full access to Basecamp from your terminal.
 
 <details>
@@ -44,7 +59,7 @@ scoop bucket add basecamp https://github.com/basecamp/homebrew-tap
 scoop install basecamp-cli
 ```
 
-**Shell script:**
+**Shell script (macOS/Linux/WSL/Git Bash):**
 ```bash
 curl -fsSL https://raw.githubusercontent.com/basecamp/basecamp-cli/main/scripts/install.sh | bash
 ```

install.md

@@ -16,13 +16,21 @@ Install the Basecamp CLI and connect it to your AI agent. Execute all steps auto
 
 ## Step 1: Install Basecamp CLI
 
-Run this in your terminal:
+Run the matching command for your environment:
 
+**macOS / Linux / WSL / Git Bash**
 ```bash
 curl -fsSL https://basecamp.com/install-cli | bash
 ```
 
-> **Note:** The install script auto-detects non-interactive environments (CI, piped input, coding agents) and skips the interactive setup wizard. You can also explicitly skip it with `BASECAMP_SKIP_SETUP=1`.
+**Windows PowerShell**
+```powershell
+irm https://raw.githubusercontent.com/basecamp/basecamp-cli/main/scripts/install.ps1 | iex
+```
+
+> **Note:** The install scripts auto-detect non-interactive environments (CI, piped input, coding agents) and skip the interactive setup wizard. You can also explicitly skip it with `BASECAMP_SKIP_SETUP=1`.
+>
+> **Windows note:** if `curl` fails with a `schannel` / `CRYPT_E_NO_REVOCATION_CHECK` TLS error, prefer the PowerShell installer, Scoop, or Git Bash's `/usr/bin/curl` instead of the system `curl.exe`.
 
 Alternatively install manually:
 
@@ -31,13 +39,18 @@ Alternatively install manually:
 brew install --cask basecamp/tap/basecamp-cli
 ```
 
-### Option B: Scoop (Windows)
+### Option B: PowerShell (Windows)
+```powershell
+irm https://raw.githubusercontent.com/basecamp/basecamp-cli/main/scripts/install.ps1 | iex
+```
+
+### Option C: Scoop (Windows)
 ```bash
 scoop bucket add basecamp https://github.com/basecamp/homebrew-tap
 scoop install basecamp-cli
 ```
 
-### Option C: Linux package (Debian/Ubuntu, Fedora/RHEL, Alpine)
+### Option D: Linux package (Debian/Ubuntu, Fedora/RHEL, Alpine)
 ```bash
 # Download the matching package from https://github.com/basecamp/basecamp-cli/releases/latest
 sudo apt install ./basecamp-cli_*_linux_amd64.deb            # Debian/Ubuntu
@@ -46,17 +59,17 @@ sudo apk add --allow-untrusted ./basecamp-cli_*_linux_amd64.apk  # Alpine
 ```
 Arm64: substitute `arm64` for `amd64` in the filename. Verify the SHA-256 checksum from `checksums.txt` before installing unsigned Alpine packages.
 
-### Option D: Nix
+### Option E: Nix
 ```bash
 nix profile install github:basecamp/basecamp-cli
 ```
 
-### Option E: Go install
+### Option F: Go install
 ```bash
 go install github.com/basecamp/basecamp-cli/cmd/basecamp@latest
 ```
 
-### Option F: GitHub Release
+### Option G: GitHub Release
 Download the archive for your platform from [Releases](https://github.com/basecamp/basecamp-cli/releases), extract, and move `basecamp` to a directory on your PATH.
 
 **Verify:**
@@ -65,9 +78,10 @@ basecamp --version
 # Expected: basecamp version X.Y.Z
 ```
 
-If `basecamp: command not found`, add to PATH:
+If `basecamp: command not found`, add it to PATH:
 ```bash
-export PATH="$HOME/.local/bin:$PATH"
+export PATH="$HOME/.local/bin:$PATH"   # macOS / Linux / WSL
+export PATH="$HOME/bin:$PATH"          # Git Bash / Windows bash environments
 # or for go install:
 export PATH="$HOME/go/bin:$PATH"
 ```

scripts/ensure-basecamp.sh

@@ -11,14 +11,42 @@ set -euo pipefail
 
 MIN_VERSION="${BASECAMP_MIN_VERSION:-0.1.0}"
 INSTALL_URL="https://github.com/basecamp/basecamp-cli"
-BIN_DIR="${BASECAMP_BIN_DIR:-$HOME/.local/bin}"
+BIN_DIR="${BASECAMP_BIN_DIR:-}"
+CURL_SCHANNEL_FALLBACK_FLAG=""
+CURL_LAST_ERROR=""
+CURL_FALLBACK_NOTED=0
 
 # Parse semver: returns 0 if $1 >= $2
 version_gte() {
   local v1="$1" v2="$2"
   printf '%s\n%s\n' "$v2" "$v1" | sort -V | head -1 | grep -qx "$v2"
 }
 
+path_contains_dir() {
+  local dir="$1"
+  [[ ":$PATH:" == *":$dir:"* ]]
+}
+
+default_bin_dir() {
+  local platform="$1"
+
+  if path_contains_dir "$HOME/bin"; then
+    echo "$HOME/bin"
+    return 0
+  fi
+
+  if path_contains_dir "$HOME/.local/bin"; then
+    echo "$HOME/.local/bin"
+    return 0
+  fi
+
+  if [[ "$platform" == windows_* ]]; then
+    echo "$HOME/bin"
+  else
+    echo "$HOME/.local/bin"
+  fi
+}
+
 check_basecamp() {
   if ! command -v basecamp &>/dev/null; then
     echo "basecamp not found in PATH"
@@ -60,23 +88,100 @@ detect_platform() {
   echo "${os}_${arch}"
 }
 
+detect_curl_fallback() {
+  local version_output help_output
+
+  version_output=$(curl --version 2>/dev/null || true)
+  if [[ "$version_output" != *[Ss]channel* ]]; then
+    return 0
+  fi
+
+  help_output=$(curl --help all 2>/dev/null || true)
+  if [[ "$help_output" == *"--ssl-revoke-best-effort"* ]]; then
+    CURL_SCHANNEL_FALLBACK_FLAG="--ssl-revoke-best-effort"
+  elif [[ "$help_output" == *"--ssl-no-revoke"* ]]; then
+    CURL_SCHANNEL_FALLBACK_FLAG="--ssl-no-revoke"
+  fi
+}
+
+curl_run() {
+  local err_file status err
+  err_file=$(mktemp "${TMPDIR:-/tmp}/basecamp-curl.XXXXXX")
+
+  if curl "$@" 2>"$err_file"; then
+    rm -f "$err_file"
+    CURL_LAST_ERROR=""
+    return 0
+  else
+    status=$?
+  fi
+
+  err=$(<"$err_file")
+  rm -f "$err_file"
+
+  if [[ $status -ne 0 ]] && [[ -n "$CURL_SCHANNEL_FALLBACK_FLAG" ]] && [[ "$err" == *"CRYPT_E_NO_REVOCATION_CHECK"* ]]; then
+    if [[ $CURL_FALLBACK_NOTED -eq 0 ]]; then
+      echo "Retrying curl with ${CURL_SCHANNEL_FALLBACK_FLAG} because Windows certificate revocation checks are unavailable..." >&2
+      CURL_FALLBACK_NOTED=1
+    fi
+
+    err_file=$(mktemp "${TMPDIR:-/tmp}/basecamp-curl.XXXXXX")
+    if curl "$CURL_SCHANNEL_FALLBACK_FLAG" "$@" 2>"$err_file"; then
+      rm -f "$err_file"
+      CURL_LAST_ERROR=""
+      return 0
+    else
+      status=$?
+    fi
+
+    err=$(<"$err_file")
+    rm -f "$err_file"
+  fi
+
+  CURL_LAST_ERROR="$err"
+  return "$status"
+}
+
+get_latest_version() {
+  local url version api_json
+
+  if url=$(curl_run -fsSL -o /dev/null -w '%{url_effective}' "https://github.com/basecamp/basecamp-cli/releases/latest"); then
+    version="${url##*/}"
+    version="${version#v}"
+    if [[ $version =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]]; then
+      echo "$version"
+      return 0
+    fi
+  fi
+
+  if api_json=$(curl_run -fsSL -H 'Accept: application/vnd.github+json' -H 'User-Agent: basecamp-cli-installer' "https://api.github.com/repos/basecamp/basecamp-cli/releases/latest"); then
+    version="${api_json#*\"tag_name\":\"v}"
+    version="${version%%\"*}"
+    if [[ $version =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]]; then
+      echo "$version"
+      return 0
+    fi
+  fi
+
+  echo "Could not determine latest version${CURL_LAST_ERROR:+ ($CURL_LAST_ERROR)}" >&2
+  return 1
+}
+
 install_basecamp() {
   echo "Installing basecamp..."
 
   local platform version url archive_name ext tmp_dir
 
   # Get platform
   platform=$(detect_platform) || return 1
+  detect_curl_fallback
 
-  # Get latest version via redirect (avoids GitHub API rate limits and grep/sed on Windows)
-  url=$(curl -fsSL -o /dev/null -w '%{url_effective}' "https://github.com/basecamp/basecamp-cli/releases/latest" 2>/dev/null) || true
-  version="${url##*/}"
-  version="${version#v}"
-  if [[ ! $version =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-    echo "Could not determine latest version (resolved '${version:-<empty>}' from '${url:-<no URL>}')" >&2
-    return 1
+  if [[ -z "$BIN_DIR" ]]; then
+    BIN_DIR=$(default_bin_dir "$platform")
   fi
 
+  version=$(get_latest_version) || return 1
+
   # Determine archive extension
   if [[ "$platform" == windows_* ]]; then
     ext="zip"
@@ -90,10 +195,10 @@ install_basecamp() {
   echo "Downloading basecamp v${version} for ${platform}..."
 
   tmp_dir=$(mktemp -d)
-  trap 'rm -rf "$tmp_dir"' EXIT
+  trap "rm -rf '${tmp_dir}'" EXIT
 
-  if ! curl -fsSL "$url" -o "${tmp_dir}/${archive_name}"; then
-    echo "Failed to download from $url" >&2
+  if ! curl_run -fsSL "$url" -o "${tmp_dir}/${archive_name}"; then
+    echo "Failed to download from $url${CURL_LAST_ERROR:+ ($CURL_LAST_ERROR)}" >&2
     return 1
   fi
 
@@ -121,7 +226,7 @@ install_basecamp() {
   if [[ ":$PATH:" != *":$BIN_DIR:"* ]]; then
     echo ""
     echo "Add to your shell profile:"
-    echo "  export PATH=\"\$HOME/.local/bin:\$PATH\""
+    echo "  export PATH=\"$BIN_DIR:\$PATH\""
   fi
 }
 
@@ -146,7 +251,7 @@ Usage:
 
 Environment:
   BASECAMP_MIN_VERSION   Minimum required version (default: $MIN_VERSION)
-  BASECAMP_BIN_DIR       Binary directory (default: ~/.local/bin)
+  BASECAMP_BIN_DIR       Binary directory (default: ~/.local/bin, or ~/bin on Windows)
 EOF
       ;;
     *)