Claude/purge reinstall commands d g5 iw

QUICKSTART.md

@@ -57,6 +57,31 @@ cd AIworkbench
 ./install.sh
 ```
 
+**Purge (Complete Removal):**
+```bash
+# Linux/macOS: remove all AIWB files, binaries, and workspace data
+rm -f ~/.local/bin/aiwb ~/.local/bin/aiwb_headless
+rm -rf ~/.local/bin/lib/
+rm -rf ~/.aiwb/
+sed -i '/# AIworkbench installer/d' ~/.bashrc 2>/dev/null || true
+sed -i '/export PATH=.*\.local\/bin/d' ~/.bashrc 2>/dev/null || true
+source ~/.bashrc
+
+# Or use the uninstall script (interactive — will prompt for confirmation)
+curl -fsSL https://raw.githubusercontent.com/juanitto-maker/AIworkbench/main/uninstall.sh | bash
+```
+
+**Purged Reinstall (Clean Slate):**
+```bash
+# Linux/macOS: purge then reinstall in one sequence
+rm -f ~/.local/bin/aiwb ~/.local/bin/aiwb_headless && \
+rm -rf ~/.local/bin/lib/ ~/.aiwb/ && \
+curl -fsSL https://raw.githubusercontent.com/juanitto-maker/AIworkbench/main/install.sh | bash
+
+# Termux: the Termux installer includes a full nuclear cleanup automatically
+curl -fsSL https://raw.githubusercontent.com/juanitto-maker/AIworkbench/main/install-termux.sh | bash
+```
+
 **Add to PATH:**
 ```bash
 export PATH="$HOME/.local/bin:$PATH"

README.md

@@ -67,6 +67,31 @@ curl -fsSL https://raw.githubusercontent.com/juanitto-maker/AIworkbench/main/ins
 aiwb
 ```
 
+### Purge (Complete Removal)
+```bash
+# Linux/macOS: remove all AIWB files, binaries, and workspace data
+rm -f ~/.local/bin/aiwb ~/.local/bin/aiwb_headless
+rm -rf ~/.local/bin/lib/
+rm -rf ~/.aiwb/
+sed -i '/# AIworkbench installer/d' ~/.bashrc 2>/dev/null || true
+sed -i '/export PATH=.*\.local\/bin/d' ~/.bashrc 2>/dev/null || true
+source ~/.bashrc
+
+# Or use the uninstall script (interactive — will prompt for confirmation)
+curl -fsSL https://raw.githubusercontent.com/juanitto-maker/AIworkbench/main/uninstall.sh | bash
+```
+
+### Purged Reinstall (Clean Slate)
+```bash
+# Linux/macOS: purge then reinstall in one sequence
+rm -f ~/.local/bin/aiwb ~/.local/bin/aiwb_headless && \
+rm -rf ~/.local/bin/lib/ ~/.aiwb/ && \
+curl -fsSL https://raw.githubusercontent.com/juanitto-maker/AIworkbench/main/install.sh | bash
+
+# Termux: the Termux installer includes a full nuclear cleanup automatically
+curl -fsSL https://raw.githubusercontent.com/juanitto-maker/AIworkbench/main/install-termux.sh | bash
+```
+
 ### 2\. Add to PATH
 Ensure `~/.local/bin` is on your PATH:
 ```bash

install.sh

@@ -26,7 +26,7 @@ DEST_BIN_FALLBACK="${HOME}/bin"
 # Note: awk is provided by 'gawk' in Termux, handled separately
 # python3 is needed for JSON escaping in runner scripts
 NEEDED_CMDS=(bash jq curl git fzf sed tar python3)
-OPT_CMDS=(gum age)
+OPT_CMDS=(age)
 
 # Pin a known-good gum if we must fetch manually (used as last resort)
 GUM_VERSION="${AIWB_GUM_VERSION:-0.13.0}"
@@ -189,15 +189,17 @@ if ! have python3 && ! have python; then
   fi
 fi
 
+# Required: gum (TUI — must be installed for AIWB to function)
+msg "Installing gum (required for TUI)…"
+if ! have gum; then
+  fetch_gum_to "$PM" "$DEST_BIN" || { err "gum installation failed. Please install gum manually: https://github.com/charmbracelet/gum"; exit 1; }
+fi
+msg "gum OK ($(command -v gum))"
+
 # Optional deps (age for encrypted key vault)
 msg "Ensuring optional dependencies: ${OPT_CMDS[*]}"
 install_pkgs "$PM" "${OPT_CMDS[@]}" || true
 
-# Special handling for gum (some distros lack it)
-if ! have gum; then
-  fetch_gum_to "$PM" "$DEST_BIN" || warn "gum not installed; TUI will be simplified until you install gum."
-fi
-
 # Create workspace
 msg "Preparing AIWB workspace at ${AIWB_HOME}"
 ensure_dir "${WORKSPACE_DIR}/projects"
@@ -295,4 +297,3 @@ echo " Workspace:  ${WORKSPACE_DIR}"
 echo " Binaries:   ${DEST_BIN} (ensure your shell has it in PATH)"
 echo
 echo "Try:   aiwb"
-echo "If gum wasn't available, install it later for the full TUI experience."