Add install.sh and document release install

Add a simple install/uninstall script (install.sh) to copy the perspective binary and mlx.metallib into a target directory (default /usr/local/bin). Update build.sh to include install.sh in the distribution stage and to print instructions that use the installer (tar + ./install.sh). Update README.md with new "Install from Release" instructions, examples for custom install path and uninstall, and adjusted build/release instructions (including swift run and ./build.sh dist). These changes make creating and installing releases easier and document the recommended install flow.

Author: mikedoise

README.md

@@ -11,19 +11,41 @@ A lightweight, open-source Swift CLI for running **Apple Foundation Models** and
 
 Foundation Models requires Apple Intelligence to be enabled. MLX mode works on any Apple Silicon Mac.
 
-## Quick Start
+## Install from Release
+
+Download the latest release archive, then:
+
+```bash
+tar xzf perspective-cli-*.tar.gz
+cd perspective-cli-*
+./install.sh
+```
+
+This installs `perspective` and `mlx.metallib` to `/usr/local/bin/`. To install elsewhere:
+
+```bash
+./install.sh /opt/bin
+```
+
+To uninstall:
+
+```bash
+./install.sh --uninstall
+```
+
+## Build from Source
 
 ```bash
 git clone https://github.com/your-username/PerspectiveCLI.git
 cd PerspectiveCLI
 ./build.sh
+swift run PerspectiveCLI
 ```
 
-Or build manually:
+To create a release archive:
 
 ```bash
-swift build
-swift run PerspectiveCLI
+./build.sh dist
 ```
 
 ## Usage

build.sh

@@ -110,6 +110,7 @@ if $DIST; then
 
     cp "$BIN_DIR/PerspectiveCLI" "$STAGE/perspective"
     cp "$METALLIB" "$STAGE/mlx.metallib"
+    cp "$PROJECT_DIR/install.sh" "$STAGE/"
     cp "$PROJECT_DIR/LICENSE" "$STAGE/" 2>/dev/null || true
     cp "$PROJECT_DIR/README.md" "$STAGE/"
 
@@ -122,10 +123,10 @@ if $DIST; then
     echo "  $ARCHIVE"
     echo "  SHA-256: $SHA"
     echo ""
-    echo "To install manually:"
+    echo "To install:"
     echo "  tar xzf $(basename "$ARCHIVE")"
-    echo "  cp perspective-cli-${VERSION}/perspective /usr/local/bin/"
-    echo "  cp perspective-cli-${VERSION}/mlx.metallib /usr/local/bin/"
+    echo "  cd perspective-cli-${VERSION}"
+    echo "  ./install.sh"
 fi
 
 echo "Build complete."

install.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# install.sh — Install PerspectiveCLI
+#
+# Usage:
+#   ./install.sh              Install to /usr/local/bin (default)
+#   ./install.sh /custom/path Install to a custom directory
+#   ./install.sh --uninstall  Remove installed files
+
+set -euo pipefail
+
+INSTALL_DIR="${1:-/usr/local/bin}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# ── Uninstall ─────────────────────────────────────────────────────────
+if [ "${1:-}" = "--uninstall" ]; then
+    INSTALL_DIR="/usr/local/bin"
+    echo "Uninstalling Perspective CLI from $INSTALL_DIR..."
+    rm -f "$INSTALL_DIR/perspective"
+    rm -f "$INSTALL_DIR/mlx.metallib"
+    echo "Done."
+    exit 0
+fi
+
+# ── Install ───────────────────────────────────────────────────────────
+echo "Installing Perspective CLI to $INSTALL_DIR..."
+
+# Check that the binary exists in the same directory as this script
+if [ ! -f "$SCRIPT_DIR/perspective" ]; then
+    echo "Error: 'perspective' binary not found in $SCRIPT_DIR"
+    echo "Run this script from inside the extracted archive."
+    exit 1
+fi
+
+# Create install directory if needed
+mkdir -p "$INSTALL_DIR"
+
+# Copy files
+cp "$SCRIPT_DIR/perspective" "$INSTALL_DIR/perspective"
+chmod +x "$INSTALL_DIR/perspective"
+
+if [ -f "$SCRIPT_DIR/mlx.metallib" ]; then
+    cp "$SCRIPT_DIR/mlx.metallib" "$INSTALL_DIR/mlx.metallib"
+fi
+
+echo "Done."
+echo ""
+echo "  perspective  → $INSTALL_DIR/perspective"
+if [ -f "$SCRIPT_DIR/mlx.metallib" ]; then
+    echo "  mlx.metallib → $INSTALL_DIR/mlx.metallib"
+fi
+echo ""
+
+# Check if install dir is on PATH
+if ! echo "$PATH" | tr ':' '\n' | grep -qx "$INSTALL_DIR"; then
+    echo "Note: $INSTALL_DIR is not on your PATH."
+    echo "Add it with: export PATH=\"$INSTALL_DIR:\$PATH\""
+fi