Co-locate mlx.metallib with binary and update install

Ensure mlx.metallib is colocated with the executable and make installs/symlinks compatible with Homebrew. Formula: install the binary and mlx.metallib into libexec and create a bin symlink so dladdr-based lookup finds mlx.metallib next to the real executable. Swift: on startup resolve the real executable path and chdir to its directory (resolving symlinks) so metallib lookup succeeds even when the binary is symlinked. Docs: reorganize README Install section with explicit Homebrew, shell script, and manual download instructions.

Author: mikedoise

Formula/perspective.rb

@@ -9,8 +9,12 @@ class Perspective < Formula
   depends_on :macos
 
   def install
-    bin.install "perspective"
-    lib.install "mlx.metallib" if File.exist?("mlx.metallib")
+    # Both files must be colocated — mlx-swift uses dladdr to find mlx.metallib
+    # next to the binary at runtime. Using libexec keeps them together while
+    # symlinking the executable into bin/ on the PATH.
+    libexec.install "perspective"
+    libexec.install "mlx.metallib" if File.exist?("mlx.metallib")
+    bin.install_symlink libexec/"perspective"
   end
 
   test do

README.md

@@ -17,15 +17,25 @@ 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.
 
-## Install from Release
+## Install
 
-The quickest way to install:
+### Homebrew
+
+```bash
+brew install techopolis/tap/perspective
+```
+
+### Shell Script
+
+The quickest way to install without Homebrew:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/techopolis/PerspectiveCLI/main/scripts/remote-install.sh | bash
 ```
 
-Or download the latest release archive manually:
+### Manual Download
+
+Download the latest release archive from [Releases](https://github.com/techopolis/PerspectiveCLI/releases), then:
 
 ```bash
 tar xzf perspective-cli-*.tar.gz

Sources/PerspectiveCLI/PerspectiveCLI.swift

@@ -15,8 +15,22 @@ import FoundationModels
 @main
 struct PerspectiveCLI {
     static func main() async {
+        // mlx-swift uses dladdr to find mlx.metallib next to the binary.
+        // When installed via symlink (e.g. Homebrew) or relocated, that lookup
+        // can fail. Resolve the real executable path and chdir there so the
+        // colocated metallib search succeeds regardless of install location.
+        Self.chdirToExecutableDirectory()
+
         await CLIApp.shared.run()
     }
+
+    /// Change working directory to the real (symlink-resolved) executable directory.
+    private static func chdirToExecutableDirectory() {
+        let execPath = ProcessInfo.processInfo.arguments[0]
+        let execURL = URL(fileURLWithPath: execPath).resolvingSymlinksInPath()
+        let dir = execURL.deletingLastPathComponent().path
+        FileManager.default.changeCurrentDirectoryPath(dir)
+    }
 }
 
 // MARK: - Error Types