Complete binary distribution setup and update documentation

- Add build:binaries script to package.json
- Update TODO.md to mark all binary distribution tasks complete
- Add manual download documentation with platform table
- Add uninstall documentation

Binary distribution system was already implemented:
- scripts/build-binaries.ts cross-compiles for all 5 platforms
- install.sh handles platform detection and PATH modification
- release.yml uploads binaries to GitHub Releases
- update-checker.ts shows curl upgrade command

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: gricha

TODO.md

@@ -16,64 +16,7 @@
 
 ## Tasks
 
-### Binary Distribution via Curl Install Script
-
-Switch from npm-based distribution to standalone binary distribution with curl install script (like OpenCode/Claude Code).
-
-**Benefits:**
-- No runtime dependency (currently requires Bun installed globally)
-- Single binary, faster cold starts with bytecode compilation
-- Simpler: `curl -fsSL https://raw.githubusercontent.com/gricha/perry/main/install.sh | bash`
-
-#### Phase 1: Binary Build System
-
-- [ ] Create binary build script using Bun's `--compile` flag for all platforms:
-  - `perry-linux-x64` (glibc)
-  - `perry-linux-arm64` (glibc)
-  - `perry-darwin-x64` (Intel Mac)
-  - `perry-darwin-arm64` (Apple Silicon)
-  - `perry-windows-x64.exe`
-- [ ] Use `--minify --bytecode` flags for optimized binaries
-- [ ] Handle web UI assets embedding (investigate Bun file embedding)
-- [ ] Add `build:binaries` script to package.json
-- [ ] Test compiled binary runs basic commands locally
-
-#### Phase 2: Install Script
-
-- [ ] Create `install.sh` at repository root with:
-  - Platform detection (Darwin/Linux via uname)
-  - Architecture detection (x64/arm64)
-  - GitHub releases API to fetch latest version
-  - Download binary from GitHub releases
-  - Install to `$HOME/.perry/bin` (or `$PERRY_INSTALL_DIR`)
-  - PATH modification (.bashrc, .zshrc, config.fish, .profile)
-  - Post-install verification (`perry --version`)
-- [ ] Support `--version` flag for specific version install
-- [ ] Support `--no-modify-path` flag
-- [ ] GitHub Actions detection (add to `$GITHUB_PATH`)
-
-#### Phase 3: Release Workflow
-
-- [ ] Add `binaries` job to `.github/workflows/release.yml`:
-  - Cross-compile for all targets using Bun
-  - Create archives (tar.gz for Linux/macOS, zip for Windows)
-  - Upload to GitHub Releases
-  - Generate SHA256 checksums
-- [ ] Keep npm publish as alternative install method
-
-#### Phase 4: Update Checker
-
-- [ ] Modify `src/update-checker.ts`:
-  - Query GitHub releases API instead of npm registry
-  - Update upgrade message to show curl command
-- [ ] (Optional) Add `perry upgrade` self-update command
-
-#### Phase 5: Documentation
-
-- [ ] Update `docs/docs/installation.md` with curl install as primary method
-- [ ] Update README.md
-- [ ] Document manual download from GitHub Releases
-- [ ] Document uninstall process
+_No tasks pending._
 
 ---
 

docs/docs/installation.md

@@ -27,6 +27,33 @@ curl -fsSL https://raw.githubusercontent.com/gricha/perry/main/install.sh | bash
 curl -fsSL https://raw.githubusercontent.com/gricha/perry/main/install.sh | bash -s -- --no-modify-path
 ```
 
+## Manual Download
+
+Download pre-built binaries directly from [GitHub Releases](https://github.com/gricha/perry/releases):
+
+| Platform | Architecture | Download |
+|----------|--------------|----------|
+| Linux | x64 | `perry-VERSION-linux-x64.tar.gz` |
+| Linux | arm64 | `perry-VERSION-linux-arm64.tar.gz` |
+| macOS | Intel | `perry-VERSION-darwin-x64.tar.gz` |
+| macOS | Apple Silicon | `perry-VERSION-darwin-arm64.tar.gz` |
+| Windows | x64 | `perry-VERSION-windows-x64.zip` |
+
+Extract and add to your PATH:
+
+```bash
+# Linux/macOS
+tar -xzf perry-*.tar.gz
+sudo mv perry-*/perry /usr/local/bin/
+sudo mv perry-*/web /usr/local/share/perry/
+
+# Or install to home directory
+mkdir -p ~/.perry/bin
+mv perry-*/perry ~/.perry/bin/
+mv perry-*/web ~/.perry/
+export PATH="$PATH:$HOME/.perry/bin"
+```
+
 ## From Source
 
 ```bash
@@ -50,3 +77,24 @@ Builds the Ubuntu 24.04 base image with dev tools. Takes 5-10 minutes, only need
 ```bash
 perry info
 ```
+
+## Uninstall
+
+To uninstall Perry:
+
+```bash
+# Remove binary and web assets
+rm -rf ~/.perry
+
+# Remove config and state (optional - keeps your workspaces config)
+rm -rf ~/.config/perry
+
+# Remove PATH entries from shell configs
+# Edit ~/.bashrc, ~/.zshrc, ~/.profile to remove the Perry lines
+```
+
+If you installed with npm:
+
+```bash
+npm uninstall -g @gricha/perry
+```

package.json

@@ -24,7 +24,8 @@
     "format:check": "oxfmt --check src/ test/",
     "check": "bun run lint && bun run format:check && bun x tsc --noEmit",
     "lint:web": "cd web && bun run lint",
-    "validate": "bun run check && bun run build && bun run test && bun run lint:web && bun run test:web"
+    "validate": "bun run check && bun run build && bun run test && bun run lint:web && bun run test:web",
+    "build:binaries": "bun run scripts/build-binaries.ts"
   },
   "engines": {
     "bun": ">=1.3.5"