homebrew-publish
Publish CLIs/TUIs to Homebrew via a personal tap. Use when asked to create or manage a Homebrew tap repo, generate or update formulae, compute sha256, test installs, or ship new releases for Go, Rust, Node/TypeScript, Python, or prebuilt binaries.
When & Why to Use This Skill
This Claude skill automates the end-to-end process of publishing and managing Command Line Interfaces (CLIs) and Terminal User Interfaces (TUIs) on Homebrew. It streamlines the creation of personal taps, generates and updates formulae for multiple programming languages including Go, Rust, Node.js, and Python, and handles technical tasks like sha256 computation and local installation testing to ensure seamless software distribution.
Use Cases
- Automating the creation of a new Homebrew tap repository for personal or organizational CLI projects.
- Generating and configuring Homebrew formulae for software written in Go, Rust, Node.js, or Python.
- Updating existing formulae with new release versions, including automatic sha256 checksum calculation.
- Performing local installation tests and audits to ensure Homebrew packages meet quality standards before public release.
| name | homebrew-publish |
|---|---|
| description | Publish CLIs/TUIs to Homebrew via a personal tap. Use when asked to create or manage a Homebrew tap repo, generate or update formulae, compute sha256, test installs, or ship new releases for Go, Rust, Node/TypeScript, Python, or prebuilt binaries. |
Homebrew Publish
Overview
Create or update a Homebrew tap and formulae so users can install a project's CLI/TUI with brew install OWNER/tap/<formula>.
Workflow
1) Gather inputs
- Confirm GitHub owner, tap name, and whether the tap repo already exists.
- Collect project repo URL, release tag/version, and the source tarball URL or prebuilt asset URL(s).
- Identify build system and language (Go, Rust, Node/TypeScript, Python, or other).
- Define binary name and a minimal
test docommand. - Confirm target platforms/architectures and whether bottles are desired.
2) Ensure tap repo exists (skip if already set)
- Create a tap repo using the short form
OWNER/tapwhen possible. - Run:
brew tap-new OWNER/homebrew-tap(orhomebrew-<tapname>)gh repo create OWNER/homebrew-tap --push --public --source "$(brew --repository OWNER/homebrew-tap)"
3) Create the formula skeleton
- Prefer stable source tarballs from release tags.
- Run:
brew create <url-to-tarball> --tap OWNER/homebrew-tap --set-name <formula>
4) Implement the formula
- Edit
Formula/<formula>.rband wire build/install/test. - Pick a language template from references:
references/formula-go.mdreferences/formula-rust.mdreferences/formula-node.mdreferences/formula-python.mdreferences/formula-prebuilt.md
- Ensure
desc,homepage,url,sha256, andlicenseare correct.
5) Compute sha256
- Use
shasum -a 256 <file>for local files. - For remote URLs, run
curl -L <url> | shasum -a 256.
6) Test locally
- Run
brew install --build-from-source OWNER/tap/<formula>. - Run
brew test OWNER/tap/<formula>. - Optionally run
brew audit --strict --online OWNER/tap/<formula>.
7) Commit and push
- Commit in the tap repo and push to GitHub.
8) Update for new releases
- Update
urlandsha256(andversionif needed). - Re-run tests, commit, and push.
Notes
- Prefer source builds unless a prebuilt binary is required.
- If bottles are enabled, keep the default workflows created by
brew tap-newand follow their publish instructions.