chore: modernize install.sh with gum UI, spinners, and CI test matrix

.github/workflows/install-matrix.yml

@@ -0,0 +1,51 @@
+name: Install Matrix
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: Matrix mode
+        required: true
+        default: dry-run
+        type: choice
+        options:
+          - dry-run
+          - full
+      gum:
+        description: Enable gum UI in matrix runs (may produce control codes in logs)
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  linux-install-matrix:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        image:
+          - ubuntu:22.04
+          - ubuntu:24.04
+          - debian:12
+          - fedora:40
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v4
+
+      - name: Run matrix (push/pr)
+        if: github.event_name != 'workflow_dispatch'
+        run: bash scripts/test-install-matrix.sh --mode dry-run --image "${{ matrix.image }}" --no-gum
+
+      - name: Run matrix (manual)
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          if [[ "${{ inputs.gum }}" == "true" ]]; then
+            GUM_FLAG="--gum"
+          else
+            GUM_FLAG="--no-gum"
+          fi
+          bash scripts/test-install-matrix.sh --mode "${{ inputs.mode }}" --image "${{ matrix.image }}" "$GUM_FLAG"

.gitignore

@@ -31,3 +31,6 @@ yarn-debug.log*
 yarn-error.log*
 .vercel
 .env*.local
+
+# Local files
+.local/

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 2026-02-10
+
+- Installer: modernize `install.sh` UX with staged progress, quieter command output, optional gum UI controls (`--gum`, `--no-gum`, `OPENCLAW_USE_GUM`, `CLAWDBOT_USE_GUM`), and verified-only temporary gum bootstrap (#50, thanks @sebslight).
+- CI: add Linux installer matrix workflow and runner script for dry-run/full validation across distro images (#50, thanks @sebslight).
+
 ## 2026-01-27
 
 - Home page: keep testimonial links clickable while skipping keyboard focus (#18, thanks @wilfriedladenhauf).

README.md

@@ -42,6 +42,11 @@ The landing page hosts installer scripts:
 - **macOS/Linux (CLI only, no onboarding)**: `curl -fsSL --proto '=https' --tlsv1.2 https://clawd.bot/install-cli.sh | bash`
 - **Windows**: `iwr -useb https://clawd.bot/install.ps1 | iex`
 
+Installer UI controls (macOS/Linux `install.sh`):
+- Pass `--gum` to force gum UI when supported, or `--no-gum` to disable gum output.
+- Set `OPENCLAW_USE_GUM=auto|1|0` to control gum behavior in automation.
+- Compatibility alias: `CLAWDBOT_USE_GUM` (mapped to `OPENCLAW_USE_GUM`).
+
 These scripts:
 1. Install Homebrew (macOS) or detect package managers (Windows)
 2. Install Node.js 22+ if needed