Add Homebrew install path

Publishes an oss-back2base formula into the existing
back2base/homebrew-back2base tap, so users can install via:

    brew install back2base/back2base/oss-back2base

- .goreleaser.yml: new brews stanza writing the formula on tag push,
  with skip_upload templated on HOMEBREW_TAP_GITHUB_TOKEN so a missing
  PAT skips only the formula publish (binaries + .deb still ship).
  Caveats walk first-run users through pre-pulling the base image
  and seeding ~/.config/back2base/env.
- release.yml: pass HOMEBREW_TAP_GITHUB_TOKEN through to goreleaser.
- README: new Install section listing Homebrew, .deb, pre-built binary,
  and from-source paths in that order. Quickstart drops the ./ prefix
  on the binary (users on PATH get `oss-back2base` directly).

Verified via `goreleaser release --snapshot --clean --skip=publish`:
formula renders cleanly with the correct download URLs, sha256s, arch
gating, docker dependency, and a `version` smoke test.

NOTE: requires HOMEBREW_TAP_GITHUB_TOKEN repo secret (PAT with `repo`
scope on back2base/homebrew-back2base) for the next tag push to
publish the formula. Without it, the brew step is skipped silently.

Author: ramseymcgrath

.github/workflows/release.yml

@@ -29,3 +29,7 @@ jobs:
           args: release --clean
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # PAT with `repo` scope on back2base/homebrew-back2base.
+          # When absent, goreleaser skips the brew publish via the
+          # disable: condition in .goreleaser.yml; binaries still ship.
+          HOMEBREW_TAP_GITHUB_TOKEN: ${{ secrets.HOMEBREW_TAP_GITHUB_TOKEN }}

.goreleaser.yml

@@ -26,6 +26,44 @@ archives:
     formats: ['tar.gz']
     name_template: "oss-back2base_{{ .Os }}_{{ .Arch }}"
 
+brews:
+  - name: oss-back2base
+    # Publish into the shared back2base tap. Lives alongside the
+    # proprietary `back2base` formula; users install with
+    #   brew install back2base/back2base/oss-back2base
+    repository:
+      owner: back2base
+      name: homebrew-back2base
+      token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
+    directory: Formula
+    homepage: "https://github.com/back2base/oss-back2base"
+    description: "Containerized Claude Code with a configurable MCP server registry (OSS)"
+    license: "MIT"
+    # Skip the formula push when the tap PAT isn't configured (e.g.
+    # community forks releasing under their own tap or local snapshot
+    # builds). Binaries + .deb still publish.
+    skip_upload: "{{ if eq .Env.HOMEBREW_TAP_GITHUB_TOKEN \"\" }}true{{ else }}false{{ end }}"
+    install: |
+      bin.install "oss-back2base"
+    caveats: |
+      oss-back2base launches a containerized Claude Code session.
+
+      First run extracts the embedded container payload to
+      ~/.local/share/back2base and builds the image (~500 MB pull
+      plus a thin local layer). To pre-fetch the base image:
+
+        docker pull ramseymcgrath/back2base-base:latest
+        oss-back2base build
+
+      Drop your Anthropic credentials into ~/.config/back2base/env
+      before the first launch. See env.example in the repo for the
+      full catalog.
+    test: |
+      system "#{bin}/oss-back2base", "version"
+    dependencies:
+      - name: docker
+        type: optional
+
 nfpms:
   - id: oss-back2base
     package_name: oss-back2base

README.md

@@ -24,30 +24,52 @@ This repository is the open-source slice: the Go CLI, the Docker container paylo
 ## Requirements
 
 - Docker (Desktop, Colima, or any compatible daemon)
-- Go 1.23+ (only needed to build from source; release binaries are available on the [Releases page](https://github.com/back2base/oss-back2base/releases))
 - An Anthropic credential — either a Claude Code OAuth token (uses your subscription) or an `ANTHROPIC_API_KEY`
 
-## Quickstart
+## Install
+
+### Homebrew (macOS / Linux)
 
 ```bash
-# 1. Build (or download a release binary from the Releases page)
-go build -o oss-back2base .
+brew install back2base/back2base/oss-back2base
+```
+
+### Debian / Ubuntu
+
+Download `oss-back2base_<version>_linux_<arch>.deb` from the [Releases page](https://github.com/back2base/oss-back2base/releases) and install it:
+
+```bash
+sudo dpkg -i oss-back2base_*_linux_amd64.deb
+```
+
+### Pre-built binary
 
-# 2. Authenticate. Either:
+Grab the matching tarball from the [Releases page](https://github.com/back2base/oss-back2base/releases), extract `oss-back2base`, and move it onto your `$PATH`.
+
+### From source
+
+```bash
+go build -o oss-back2base .   # requires Go 1.23+
+```
+
+## Quickstart
+
+```bash
+# 1. Authenticate. Either:
 claude setup-token                                     # OAuth, uses your Claude subscription
 # …or grab an Anthropic API key from https://console.anthropic.com
 
-# 3. Drop the credential into the env file
+# 2. Drop the credential into the env file
 mkdir -p ~/.config/back2base
 cat > ~/.config/back2base/env <<'EOF'
 BACK2BASE_CLAUDE_CODE_OAUTH_TOKEN=<paste-token-here>
 # or, if using an API key instead:
 # BACK2BASE_ANTHROPIC_API_KEY=sk-ant-...
 EOF
 
-# 4. Launch. First run extracts the container payload to ~/.local/share/back2base
+# 3. Launch. First run extracts the container payload to ~/.local/share/back2base
 #    and builds the image (~500 MB pull + a thin local layer).
-./oss-back2base
+oss-back2base
 ```
 
 Other useful entry points: