Skip to content

Conversation

@panbanda
Copy link

@panbanda panbanda commented Nov 17, 2025

Summary

Fixes the Homebrew tap structure by renaming the homebrew/ directory to Formula/, enabling proper formula discovery and updates all automation workflows to reference the new path.

Fixes #73

Problem

The current tap structure stores the formula in homebrew/pmat.rb, but Homebrew expects formulas to be in either:

  • Root directory: pmat.rb
  • Formula directory: Formula/pmat.rb

This prevents brew install paiml/pmat/pmat from working after tapping the repository.

Changes

Directory Structure

  • Renamed homebrew/ directory to Formula/
  • All supporting files (README.md, test scripts) moved with the formula

Automation Updates

Updated all workflows and scripts to reference Formula/pmat.rb:

  • .github/workflows/homebrew-update.yml - Automated version updates
  • .github/workflows/multi-ecosystem-release.yml - Multi-ecosystem release workflow
  • Formula/test-formula.sh - Local formula testing script
  • docs/DISTRIBUTION_STATUS.md - Documentation

Testing

After this change, users can install pmat via:

brew tap paiml/pmat https://github.com/paiml/paiml-mcp-agent-toolkit
brew install paiml/pmat/pmat

Verified locally that the formula is discoverable in the new location.

Impact

  • Automated version updates will continue working with the new path
  • GitHub Actions workflows will properly update Formula/pmat.rb on new releases
  • No manual intervention needed for version bumps

Related

This follows the standard Homebrew tap structure documented at:
https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap

Homebrew taps require formulas to be in a Formula/ directory at the
repository root. The previous homebrew/ directory location prevented
brew from finding the pmat formula when using the tap.

This enables proper installation via:
  brew tap paiml/pmat https://github.com/paiml/paiml-mcp-agent-toolkit
  brew install paiml/pmat/pmat
Update all automation workflows and scripts to reference the new
Formula/pmat.rb path instead of homebrew/pmat.rb:

- .github/workflows/homebrew-update.yml
- .github/workflows/multi-ecosystem-release.yml
- Formula/test-formula.sh
- docs/DISTRIBUTION_STATUS.md

This ensures automated version updates will continue working after
the directory rename.
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.

Homebrew installation method documented but not implemented

1 participant