BeClaude

homebrew-tap

New
2Community RegistryDevelopmentby Paul Thrasher

Manage Homebrew taps for distributing CLI tools and macOS apps

First seen 5/22/2026

Summary

This skill streamlines the creation and management of Homebrew taps for distributing CLI tools and macOS applications.

  • It automates tap setup, formula generation, and release workflows, making it easier for developers to share software via Homebrew.

Overview

A Claude Code plugin marketplace with development workflows, Rust tooling, and best practices.

Installation

Option 1: Add the marketplace (recommended)

bash
# Add marketplace via CLI
claude plugin marketplace add thrashr888/thrashr888-agent-kit

# Install individual skills
claude plugin install style-docs@thrashr888-agent-kit
claude plugin install github-releases@thrashr888-agent-kit
claude plugin install makefile-patterns@thrashr888-agent-kit
claude plugin install rust-development@thrashr888-agent-kit
claude plugin install rust-onboard@thrashr888-agent-kit
claude plugin install rust-release@thrashr888-agent-kit
claude plugin install rust-best-practices@thrashr888-agent-kit
claude plugin install python-uv@thrashr888-agent-kit
claude plugin install hcp-terraform@thrashr888-agent-kit
claude plugin install homebrew-tap@thrashr888-agent-kit

Option 2: Direct configuration

Add to your project's .claude/settings.local.json:

json
{
  "plugins": ["thrashr888/thrashr888-agent-kit"]
}

Skills (10 total)

Development

SkillDescription
style-docs5-style documentation system (plans, specs, skills, RFCs, ADRs)
github-releasesRelease workflows for Rust, macOS apps, Python/uv, Next.js
makefile-patternsMakefile patterns for dev, build, test, and release automation

Rust

SkillDescription
rust-developmentQuality gates, testing, iteration patterns
rust-onboardProject setup with CI/CD and Homebrew
rust-releaseMulti-platform builds, GitHub Releases, Homebrew taps
rust-best-practicesIdiomatic patterns, error handling, API design

Python

SkillDescription
python-uvModern Python with uv, pytest, FastAPI, Django, EC2 deploy

Infrastructure

SkillDescription
hcp-terraformHCP Terraform (Terraform Cloud) remote plan/apply workflow
homebrew-tapManage Homebrew formulas and casks for distribution

Skill Details

style-docs

Generate standardized project documentation using the 5-style system.

Use when: Creating plans, specs, skills, RFCs, ADRs, or other project documentation.

github-releases

Release workflows for multiple tech stacks.

Supports:

  • Rust CLI (tag-triggered, multi-platform, Homebrew)
  • macOS apps (Makefile, notarization, S3, Sparkle)
  • Python/uv (EC2 deploy with health checks)
  • Next.js (Vercel auto-deploy)

python-uv

Modern Python development with uv package manager.

Use when: Working on Python projects using uv, pytest, FastAPI, or Django.

Covers:

  • uv sync, add, run commands
  • pytest testing patterns
  • FastAPI/Django development
  • EC2 deployment with health checks
  • GitHub Actions CI

hcp-terraform

HCP Terraform (Terraform Cloud) workflow.

Use when: Working with Terraform that runs remotely in HCP Terraform.

Key constraint: Cannot apply locally - all plans/applies run in HCP Terraform.

homebrew-tap

Manage Homebrew taps for distributing software.

Use when: Creating or updating Homebrew formulas (CLI tools) or casks (macOS apps).

makefile-patterns

Common Makefile patterns for automation.

Use when: Creating or understanding Makefiles for build, test, and release workflows.

Includes:

  • Dev loop (kill, build, run)
  • Rust, Xcode, Python build patterns
  • DMG creation, S3 upload
  • Homebrew tap updates
  • Git tagging

Project Structure

code
thrashr888-agent-kit/
├── .claude-plugin/
│   ├── plugin.json           # Plugin configuration
│   └── marketplace.json      # Marketplace catalog (10 plugins)
├── skills/
│   ├── style-docs/           # Documentation templates
│   ├── github-releases/      # Release workflows
│   ├── makefile-patterns/    # Makefile automation
│   ├── rust-development/     # Rust dev workflow
│   ├── rust-onboard/         # Rust project setup
│   ├── rust-release/         # Rust release workflow
│   ├── rust-best-practices/  # Rust coding guidelines
│   ├── python-uv/            # Python/uv development
│   ├── hcp-terraform/        # Terraform Cloud workflow
│   └── homebrew-tap/         # Homebrew distribution
├── CLAUDE.md
├── AGENTS.md
└── README.md

The 5-Style Documentation System

StylePurposeLocation
1. Plan ModeDeep exploration before codingplans/
2. IssuesTrack work across sessions.beads/ or GH
3. Evergreen SpecsSystem truth ("how it works")specs/
4. SkillsAgent guides ("how to implement").claude/skills/
5. User DocsHuman communicationREADME, CLAUDE.md

Contributing

Skills are designed to be focused and reusable. When adding new skills:

  1. Create a directory under skills/
  2. Add SKILL.md with frontmatter (name, description, allowed-tools)
  3. Add references/ for supporting docs
  4. Add scripts/ for automation helpers
  5. Update marketplace.json and this README

License

MIT

Install & Usage

1
Add a marketplace
/plugin marketplace add <org/repo>
2
Install the plugin

Add the configuration to /plugin install homebrew-tap@<marketplace>

3
Manage with /plugin
/plugin

Use Cases

Create a new Homebrew tap repository with proper structure and configuration.
Generate a Homebrew formula for a CLI tool or macOS app from existing build artifacts.
Automate the release process by updating a tap's formula with new version and checksums.
Add or update multiple formulae in a tap during a bulk release cycle.
Validate a Homebrew tap's formulae for correctness and compatibility.

Usage Examples

1

/homebrew-tap create myorg/mytap --description 'My CLI tools'

2

/homebrew-tap add-formula ./path/to/tool --version 1.2.3 --url https://example.com/tool.tar.gz

3

/homebrew-tap release --tap myorg/mytap --version 2.0.0 --formula-dir ./formulae

View source on GitHub
homebrewdistributionmacoscli

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is homebrew-tap?

This skill streamlines the creation and management of Homebrew taps for distributing CLI tools and macOS applications. It automates tap setup, formula generation, and release workflows, making it easier for developers to share software via Homebrew.

How to install homebrew-tap?

To install homebrew-tap: add a marketplace (/plugin marketplace add <org/repo>), then add the config to /plugin install homebrew-tap@<marketplace>. Finally, /plugin in Claude Code.

What is homebrew-tap best for?

homebrew-tap is a plugin categorized under Development. It is designed for: homebrew, distribution, macos, cli. Created by Paul Thrasher.

What can I use homebrew-tap for?

homebrew-tap is useful for: Create a new Homebrew tap repository with proper structure and configuration.; Generate a Homebrew formula for a CLI tool or macOS app from existing build artifacts.; Automate the release process by updating a tap's formula with new version and checksums.; Add or update multiple formulae in a tap during a bulk release cycle.; Validate a Homebrew tap's formulae for correctness and compatibility..