feat(release): add Homebrew tap publish + README 60s install paths

.goreleaser.yml

@@ -119,6 +119,25 @@ changelog:
     - title: "Other"
       order: 999
 
+# ---------------------------------------------------------------------------
+# Homebrew — publishes a formula to GrayCodeAI/homebrew-tap so users can
+# `brew install graycodeai/tap/hawk`. Requires HOMEBREW_TAP_TOKEN or
+# TAP_GITHUB_TOKEN in the release workflow (both already wired there).
+# ---------------------------------------------------------------------------
+brews:
+  - repository:
+      owner: GrayCodeAI
+      name: homebrew-tap
+      token: "{{ .Env.HOMEBREW_TAP_TOKEN }}"
+    directory: Formula
+    homepage: "https://github.com/GrayCodeAI/hawk"
+    description: "AI coding agent — reads, writes, and runs code in your terminal"
+    license: "MIT"
+    install: |
+      bin.install "hawk"
+    test: |
+      system "#{bin}/hawk", "--version"
+
 # ---------------------------------------------------------------------------
 # Release — auto-detect prereleases (rc/beta tags). Created on the repo
 # itself (not a separate release repo).

README.md

@@ -43,6 +43,30 @@ hawk is an AI-powered coding agent that lives in your terminal. It reads your co
 
 Follow [GrayCode](https://github.com/GrayCodeAI) for progress. When Hawk is ready to try, we will announce it on [graycodeai.com](https://graycodeai.com/changelog).
 
+## Install (60 seconds)
+
+Pick one — all install the same `hawk` binary (versioned into `~/.hawk/bin`, symlinked as `hawk`):
+
+```bash
+# 1. Script (any shell, verifies checksum; cosign signature when available)
+curl -fsSL https://raw.githubusercontent.com/GrayCodeAI/hawk/main/install.sh | sh
+
+# 2. Homebrew (macOS / Linuxbrew) — after the next tagged release
+brew install graycodeai/tap/hawk
+
+# 3. npm (wraps the same release binaries)
+npm install -g @graycodeai/hawk
+```
+
+If `~/.hawk/bin` is not on your `PATH`, add it to your shell profile.
+
+Then:
+
+```bash
+hawk            # interactive REPL (/config on first run: API key + model)
+hawk path       # verify readiness
+```
+
 ## Quick Start (contributors — from source)
 
 ```bash