chore: improve installation scripts

Author: TristanSpeakEasy

INSTALL.md

@@ -53,6 +53,8 @@ Or with wget:
 wget -qO- https://raw.githubusercontent.com/speakeasy-api/openapi/main/scripts/install.sh | bash
 ```
 
+The script automatically detects if you have write permission to `/usr/local/bin`. If not, it installs to `~/.local/bin` instead. No sudo required!
+
 ### Windows (PowerShell)
 
 ```powershell
@@ -268,24 +270,24 @@ The PowerShell script automatically adds the installation directory to your PATH
 
 ### Permission Denied (Linux/macOS)
 
-If you get permission errors when installing to `/usr/local/bin`:
+The installation script automatically detects if you have write permission to `/usr/local/bin` and falls back to `~/.local/bin` if needed. However, if you still encounter permission issues:
 
-**Option 1:** Run with sudo (not recommended for the curl pipe method)
+**Option 1:** Explicitly set a user-writable directory
 
 ```bash
-# Download script first, review it, then run with sudo
-curl -fsSL https://raw.githubusercontent.com/speakeasy-api/openapi/main/scripts/install.sh -o install.sh
-chmod +x install.sh
-sudo ./install.sh
+OPENAPI_INSTALL_DIR=$HOME/.local/bin curl -fsSL https://raw.githubusercontent.com/speakeasy-api/openapi/main/scripts/install.sh | bash
 ```
 
-**Option 2:** Install to a user-writable directory
+**Option 2:** Run with sudo (download and review first)
 
 ```bash
-OPENAPI_INSTALL_DIR=$HOME/.local/bin curl -fsSL https://raw.githubusercontent.com/speakeasy-api/openapi/main/scripts/install.sh | bash
+# Download script first, review it, then run with sudo
+curl -fsSL https://raw.githubusercontent.com/speakeasy-api/openapi/main/scripts/install.sh -o install.sh
+chmod +x install.sh
+sudo ./install.sh
 ```
 
-Then ensure `$HOME/.local/bin` is in your PATH.
+If installed to `~/.local/bin`, ensure it's in your PATH (see [Command Not Found](#command-not-found-after-installation)).
 
 ### Windows Git Bash Issues
 

scripts/install.sh

@@ -18,7 +18,8 @@ set -e
 
 # Configuration
 REPO="speakeasy-api/openapi"
-INSTALL_DIR="${OPENAPI_INSTALL_DIR:-/usr/local/bin}"
+DEFAULT_INSTALL_DIR="/usr/local/bin"
+USER_INSTALL_DIR="$HOME/.local/bin"
 VERSION="${OPENAPI_VERSION:-latest}"
 BINARY_NAME="openapi"
 
@@ -88,13 +89,34 @@ get_latest_version() {
     echo "$version"
 }
 
+# Determine installation directory
+get_install_dir() {
+    # If user specified a directory, use it
+    if [ -n "$OPENAPI_INSTALL_DIR" ]; then
+        echo "$OPENAPI_INSTALL_DIR"
+        return
+    fi
+    
+    # Try to use /usr/local/bin if we have write access
+    if [ -w "$DEFAULT_INSTALL_DIR" ] || [ -w "$(dirname "$DEFAULT_INSTALL_DIR")" ]; then
+        echo "$DEFAULT_INSTALL_DIR"
+        return
+    fi
+    
+    # Fall back to user directory
+    log_info "No write access to $DEFAULT_INSTALL_DIR, using $USER_INSTALL_DIR instead"
+    echo "$USER_INSTALL_DIR"
+}
+
 # Download and install
 install_cli() {
+    local INSTALL_DIR=$(get_install_dir)
     local os=$(detect_os)
     local arch=$(detect_arch)
 
     log_info "Detected OS: $os"
     log_info "Detected Architecture: $arch"
+    log_info "Installation directory: $INSTALL_DIR"
 
     # Get version
     if [ "$VERSION" = "latest" ]; then
@@ -191,7 +213,10 @@ install_cli() {
         if [ "$os" = "Windows" ]; then
             log_warn "Add $INSTALL_DIR to your PATH environment variable."
         else
-            log_warn "Add $INSTALL_DIR to your PATH or run: export PATH=\"$INSTALL_DIR:\$PATH\""
+            log_warn "Add $INSTALL_DIR to your PATH by adding this to your ~/.bashrc or ~/.zshrc:"
+            log_warn "  export PATH=\"\$PATH:$INSTALL_DIR\""
+            log_warn ""
+            log_warn "Then run: source ~/.bashrc  # or source ~/.zshrc"
         fi
     fi
 }