Add improved onboarding and distribution

- Add multiple installation methods: cargo binstall, cargo install, curl script
- Add shell completions command (bash/zsh/fish/powershell)
- Add interactive `kto init` wizard for first-time setup
- Add GitHub Actions release workflow with:
  - Test job (tests, fmt check, version verification)
  - Multi-platform builds (linux x64/arm64, macos x64/arm64)
  - Automatic GitHub releases with checksums
  - crates.io publishing
- Security improvements:
  - install.sh requires checksum verification
  - install.sh uses safe tar extraction
  - Secret prompts use masked input
- Update Cargo.toml with crates.io metadata and binstall config
- Fix repository URL (devindudeman)

Author: devindudeman

.github/workflows/release.yml

@@ -0,0 +1,135 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  # Run tests before building release artifacts
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-action@stable
+
+      - name: Run tests
+        run: cargo test --all-features
+
+      - name: Check formatting
+        run: cargo fmt --check
+
+      - name: Verify package
+        run: cargo package --allow-dirty
+
+      - name: Verify version matches tag
+        run: |
+          CARGO_VERSION="v$(cargo metadata --format-version=1 --no-deps | jq -r '.packages[0].version')"
+          if [[ "$CARGO_VERSION" != "${{ github.ref_name }}" ]]; then
+            echo "Error: Cargo.toml version ($CARGO_VERSION) does not match tag (${{ github.ref_name }})"
+            exit 1
+          fi
+
+  build:
+    name: Build ${{ matrix.target }}
+    needs: test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-latest
+          - target: x86_64-apple-darwin
+            os: macos-latest
+          - target: aarch64-apple-darwin
+            os: macos-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-action@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Install cross-compilation tools (Linux ARM)
+        if: matrix.target == 'aarch64-unknown-linux-gnu'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gcc-aarch64-linux-gnu
+
+      - name: Build
+        run: |
+          if [[ "${{ matrix.target }}" == "aarch64-unknown-linux-gnu" ]]; then
+            export CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER=aarch64-linux-gnu-gcc
+          fi
+          cargo build --release --features tui --target ${{ matrix.target }}
+
+      - name: Package
+        shell: bash
+        run: |
+          cd target/${{ matrix.target }}/release
+          tar czvf ../../../kto-${{ matrix.target }}.tar.gz kto
+          cd ../../..
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: kto-${{ matrix.target }}
+          path: kto-${{ matrix.target }}.tar.gz
+
+  release:
+    name: Create Release
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Prepare release assets
+        run: |
+          mkdir -p release
+          for dir in artifacts/kto-*/; do
+            cp "$dir"/*.tar.gz release/
+          done
+          cd release
+          sha256sum *.tar.gz > checksums.txt
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            release/*.tar.gz
+            release/checksums.txt
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-crate:
+    name: Publish to crates.io
+    needs: release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-action@stable
+
+      - name: Publish to crates.io
+        run: cargo publish --token ${{ secrets.CARGO_REGISTRY_TOKEN }}

Cargo.lock

@@ -2,10 +2,31 @@
 name = "kto"
 version = "0.1.0"
 edition = "2021"
-description = "A generic, flexible web change watcher"
+description = "A generic, flexible web change watcher with AI-powered analysis"
 license = "MIT"
 readme = "README.md"
-repository = "https://github.com/devinbernosky/kto"
+repository = "https://github.com/devindudeman/kto"
+homepage = "https://github.com/devindudeman/kto"
+keywords = ["web", "monitor", "change-detection", "cli", "ai"]
+categories = ["command-line-utilities", "web-programming"]
+authors = ["devindudeman"]
+
+[package.metadata.binstall]
+pkg-url = "{ repo }/releases/download/v{ version }/{ name }-{ target }.tar.gz"
+bin-dir = "{ bin }{ binary-ext }"
+pkg-fmt = "tgz"
+
+[package.metadata.binstall.overrides.x86_64-unknown-linux-gnu]
+pkg-url = "{ repo }/releases/download/v{ version }/kto-x86_64-unknown-linux-gnu.tar.gz"
+
+[package.metadata.binstall.overrides.aarch64-unknown-linux-gnu]
+pkg-url = "{ repo }/releases/download/v{ version }/kto-aarch64-unknown-linux-gnu.tar.gz"
+
+[package.metadata.binstall.overrides.x86_64-apple-darwin]
+pkg-url = "{ repo }/releases/download/v{ version }/kto-x86_64-apple-darwin.tar.gz"
+
+[package.metadata.binstall.overrides.aarch64-apple-darwin]
+pkg-url = "{ repo }/releases/download/v{ version }/kto-aarch64-apple-darwin.tar.gz"
 
 [dependencies]
 # HTTP client (blocking, minimal)
@@ -30,6 +51,7 @@ zstd = "0.13"
 
 # CLI
 clap = { version = "4", features = ["derive"] }
+clap_complete = "4"         # Shell completions
 inquire = "0.7"             # Interactive prompts
 ctrlc = "3"                 # Ctrl+C handler
 rand = "0.8"                # Random number generation

Cargo.toml

@@ -18,37 +18,49 @@ kto monitors web pages for changes and notifies you when something interesting h
 - **Background service** - Runs as systemd/launchd service or cron job
 - **Machine-readable output** - JSON output for scripting and automation
 
+## Installation
+
+```bash
+# Recommended: prebuilt binary (fast, no compile)
+cargo binstall kto
+
+# From crates.io (requires Rust)
+cargo install kto
+
+# Via install script
+curl -fsSL https://raw.githubusercontent.com/devindudeman/kto/main/install.sh | bash
+
+# From source
+git clone https://github.com/devindudeman/kto
+cd kto && cargo install --path . --features tui
+```
+
 ## Quick Start
 
 ```bash
-# Install
-cargo install --path .
+# First-time setup (guided wizard)
+kto init
 
-# Create your first watch
+# Or manually:
 kto new "https://news.ycombinator.com for AI news"
-
-# Set up notifications
 kto notify set --ntfy my-alerts
-
-# Install as background service
 kto service install
-
-# Check status
-kto service status
 ```
 
-## Installation
+## Shell Completions
 
-### From Source
 ```bash
-git clone https://github.com/devinbernosky/kto
-cd kto
-cargo build --release --features tui
-cp target/release/kto ~/.local/bin/
+# Bash
+kto completions bash >> ~/.bashrc
+
+# Zsh
+kto completions zsh >> ~/.zshrc
+
+# Fish
+kto completions fish > ~/.config/fish/completions/kto.fish
 ```
 
-### Dependencies
-- Rust 1.70+
+## Dependencies
 - For JS rendering: Node.js + Playwright (`kto enable-js`)
 - For AI analysis: [Claude CLI](https://claude.ai/cli) (optional)