homebrew-release

Automate Homebrew formula releases with git tagging and SHA256 computation.

Updated Dec 5, 2025
One-click install
npx skills add https://github.com/mhismail3/dotfiles --skill homebrew-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homebrew-release
Source: https://github.com/mhismail3/dotfiles/tree/main/claude/skills/homebrew-release
Command: npx skills add https://github.com/mhismail3/dotfiles --skill homebrew-release

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

This Skill eliminates the complex, error-prone process of manually creating Homebrew formula releases, ensuring consistent versioning and deployment.

Core Features & Use Cases

  • Complete Release Pipeline: Automates git tagging, GitHub releases, SHA256 computation, and formula updates in one seamless workflow.
  • Tool-Specific Versioning: Supports independent version lifecycles for multiple tools in a single tap.
  • Use Case: When you've updated your CLI tool and want to publish version v1.2.3, this Skill handles everything from creating the release to updating the formula.

Quick Start

Create a new release for the mistral-ocr tool with version v0.1.1 and release notes "Fixed CLI help text".

Frequently Asked Questions about homebrew-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Homebrew formula releases with git tagging and GitHub?

Automate Homebrew formula releases by using a workflow that creates git tags, publishes GitHub releases, computes SHA256 checksums, and updates your Formula file end-to-end. This eliminates manual steps and ensures consistent versioning across your tap.

Can I automate publishing new versions of my CLI tool to Homebrew?

Yes. Automate your CLI tool releases by triggering a workflow from your homebrew-tools repository that handles tagging, release creation, tarball download, SHA256 computation, and formula updates in one seamless process.

What do I need to set up before automating a Homebrew formula release?

You need the gh CLI installed and authenticated, committed changes on main in your homebrew-tools repository, and an existing formula file under the Formula/ directory. The workflow then automates the rest.

How does SHA256 computation fit into Homebrew formula versioning?

SHA256 computation verifies the integrity of your tool's tarball during release. The automation computes this hash and updates your formula file automatically, ensuring Homebrew can validate downloads.

Can I manage multiple tool versions independently in a single Homebrew tap?

Yes. This workflow supports independent version lifecycles for multiple tools in one tap, allowing you to release version updates for specific tools without affecting others.