feat(install): add --init flag to run wizard after install

Lets users install the CLI and launch the setup wizard in one command:

    curl -fsSL https://cli.sentry.dev/install | bash -s -- --init

After the normal install completes, resolves the installed binary path
and runs `sentry init </dev/tty`. The </dev/tty is needed because
`curl | bash` consumes stdin for the pipe.

Also adds `install` to the docs-preview workflow path filter so changes
to the install script trigger a preview build.

Closes #682

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: betegon

.github/workflows/docs-preview.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
     paths:
       - 'docs/**'
+      - 'install'
       - '.github/workflows/docs-preview.yml'
 
 permissions:

install

@@ -83,6 +83,7 @@ Usage: install [options]
 Options:
     -h, --help              Display this help message
     -v, --version <version> Install a specific version (e.g., 0.2.0) or "nightly"
+        --init              Run \`sentry init\` after installing
         --no-modify-path    Don't modify shell config files (.zshrc, .bashrc, etc.)
         --no-completions    Don't install shell completions
 
@@ -92,6 +93,7 @@ Environment Variables:
 
 Examples:
     curl -fsSL https://cli.sentry.dev/install | bash
+    curl -fsSL https://cli.sentry.dev/install | bash -s -- --init
     curl -fsSL https://cli.sentry.dev/install | bash -s -- --version nightly
     curl -fsSL https://cli.sentry.dev/install | bash -s -- --version 0.19.0
     SENTRY_VERSION=nightly curl -fsSL https://cli.sentry.dev/install | bash
@@ -102,6 +104,7 @@ EOF
 requested_version="${SENTRY_VERSION:-}"
 no_modify_path=false
 no_completions=false
+run_init=false
 while [[ $# -gt 0 ]]; do
   case "$1" in
     -h|--help) usage; exit 0 ;;
@@ -113,6 +116,10 @@ while [[ $# -gt 0 ]]; do
         die "Error: --version requires a version argument" "args"
       fi
       ;;
+    --init)
+      run_init=true
+      shift
+      ;;
     --no-modify-path)
       no_modify_path=true
       shift
@@ -276,3 +283,21 @@ trap - EXIT
 
 # shellcheck disable=SC2086
 "$tmp_binary" cli setup $setup_args
+
+# Optionally launch the setup wizard after install.
+# Resolve the installed binary path using the same logic as the TS code:
+# SENTRY_INSTALL_DIR > ~/.local/bin > ~/bin > ~/.sentry/bin
+# </dev/tty reopens stdin from the terminal since `curl | bash` consumes it.
+if [[ "$run_init" == "true" ]]; then
+  sentry_bin=""
+  for dir in "${SENTRY_INSTALL_DIR:-}" "$HOME/.local/bin" "$HOME/bin" "$HOME/.sentry/bin"; do
+    if [[ -x "${dir}/sentry" ]]; then
+      sentry_bin="${dir}/sentry"
+      break
+    fi
+  done
+  if [[ -z "$sentry_bin" ]]; then
+    die "Cannot find installed sentry binary" "init"
+  fi
+  "$sentry_bin" init </dev/tty
+fi