Thank you for considering a contribution!
By participating in this project, you are expected to uphold our Code of Conduct:
- Use welcoming and inclusive language
- Be respectful of differing viewpoints and experiences
- Gracefully accept constructive criticism
- Focus on what is best for the community
- Show empathy towards other community members
First decide where the problem lives:
- A packaged tool misbehaves after a successful install — report it to that tool's own repository (per-formula ownership is in CODEOWNERS)
- A formula fails to install, has a wrong checksum, or is out of date —
open an issue here with the full
brew installoutput, your OS and architecture, andbrew config
Do not open a public issue — see SECURITY.md.
- Generated formulae (published by a source project's release automation) must not be edited by hand — changes land via the next tagged release of the source project. If a generated formula is broken, open an issue so the source project can cut a fix.
- Hand-maintained formulae: open a pull request. Follow Homebrew's formula cookbook and keep one formula change per PR.
brew test-botruns on every push and PR — it must be green before merge.- Verify locally where possible:
brew install --build-from-source <formula>,brew test <formula>,brew audit --strict <formula>. - One logical change per PR.