feat: Automatically update Homebrew

Signed-off-by: Drew Cain <groksrc@users.noreply.github.com>

.github/workflows/release.yml

@@ -51,4 +51,32 @@ jobs:
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
-          password: ${{ secrets.PYPI_TOKEN }}
+          password: ${{ secrets.PYPI_TOKEN }}
+
+  homebrew:
+    name: Update Homebrew Formula
+    needs: release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      actions: read
+    steps:
+      - name: Update Homebrew formula
+        uses: mislav/bump-homebrew-formula-action@v3
+        with:
+          # Formula name in homebrew-basic-memory repo
+          formula-name: basic-memory
+          # The tap repository
+          homebrew-tap: basicmachines-co/homebrew-basic-memory
+          # Base branch of the tap repository
+          base-branch: main
+          # Download URL will be automatically constructed from the tag
+          download-url: https://github.com/basicmachines-co/basic-memory/archive/refs/tags/${{ github.ref_name }}.tar.gz
+          # Commit message for the formula update
+          commit-message: |
+            {{formulaName}} {{version}}
+
+            Created by https://github.com/basicmachines-co/basic-memory/actions/runs/${{ github.run_id }}
+        env:
+          # Personal Access Token with repo scope for homebrew-basic-memory repo
+          COMMITTER_TOKEN: ${{ secrets.HOMEBREW_TOKEN }}

CLAUDE.md

@@ -228,12 +228,21 @@ Basic Memory uses `uv-dynamic-versioning` for automatic version management based
 - Includes comprehensive quality checks (lint, format, type-check, tests)
 - Automatically updates version in `__init__.py`
 - Creates git tag and pushes to GitHub
-- Triggers GitHub Actions workflow for PyPI publication
-- Users install with: `pip install basic-memory`
+- Triggers GitHub Actions workflow for:
+  - PyPI publication
+  - Homebrew formula update (requires HOMEBREW_TOKEN secret)
 
 **Manual method (legacy):**
 - Create version tag: `git tag v0.13.0 && git push origin v0.13.0`
 
+#### Homebrew Formula Updates
+- Automatically triggered after successful PyPI release
+- Updates formula in `basicmachines-co/homebrew-basic-memory` repo
+- Requires `HOMEBREW_TOKEN` secret in GitHub repository settings:
+  - Create a fine-grained Personal Access Token with `Contents: Read and Write` and `Actions: Read` scopes on `basicmachines-co/homebrew-basic-memory`
+  - Add as repository secret named `HOMEBREW_TOKEN` in `basicmachines-co/basic-memory`
+- Formula updates include new version URL and SHA256 checksum
+
 ### For Development
 - **Automated releases**: Use `just release v0.13.x` for stable releases and `just beta v0.13.0b1` for beta releases
 - **Quality gates**: All releases require passing lint, format, type-check, and test suites
@@ -243,4 +252,4 @@ Basic Memory uses `uv-dynamic-versioning` for automatic version management based
 - **CI/CD**: GitHub Actions handles building and PyPI publication
 
 ## Development Notes
-- make sure you sign off on commits
+- make sure you sign off on commits