Skip to content

feat: add Homebrew tap support#49

Merged
dylanjha merged 1 commit intomainfrom
dj/add-homebrew
Feb 19, 2026
Merged

feat: add Homebrew tap support#49
dylanjha merged 1 commit intomainfrom
dj/add-homebrew

Conversation

@dylanjha
Copy link
Contributor

@dylanjha dylanjha commented Feb 19, 2026

Summary

  • Adds a homebrew job to the release workflow that automatically generates and pushes an updated Homebrew formula to muxinc/homebrew-tap on each release
  • Includes a reference Formula/mux.rb in this repo (not used by the workflow directly)

Setup steps

Before the next release, the following need to be done:

  • Create the muxinc/homebrew-tap repository

  • Create a GitHub App for cross-repo access

The release workflow needs to push to muxinc/homebrew-tap from this repo. A GitHub App is used to generate a scoped token.

  1. Go to GitHub Org Settings > Developer settings > GitHub Apps > New GitHub App
  2. Name it something like Mux Homebrew Tap Bot
  3. Set the following Repository permissions:
    • Contents: Read & Write (to push formula updates)
  4. No webhook URL is needed — uncheck "Active" under Webhooks
  5. Under "Where can this GitHub App be installed?", select "Only on this account"
  6. Create the app and note the App ID
  7. Generate a private key and download it
  • Install the GitHub App
  1. Go to the app's settings > Install App
  2. Install it on the muxinc org
  3. Grant access to only the homebrew-tap repository
  • Add secrets to muxinc/cli

Add the following repository secrets (Settings > Secrets and variables > Actions):

  • HOMEBREW_APP_ID — the App ID from step 2

  • HOMEBREW_APP_PRIVATE_KEY — the full contents of the private key .pem file from step 2

  • Verify

After merging this PR, tag a release and confirm that:

  • The homebrew job runs successfully
  • muxinc/homebrew-tap has a Formula/mux.rb with the correct version and SHA256 checksums
  • brew tap muxinc/tap && brew install mux works

Adds a `homebrew` job to the release workflow that automatically
updates the Homebrew formula in muxinc/homebrew-tap on each release.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dylanjha dylanjha merged commit 113e5a0 into main Feb 19, 2026
7 checks passed
@dylanjha dylanjha deleted the dj/add-homebrew branch February 19, 2026 22:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant