0
0
Fork 0
mirror of https://github.com/Homebrew/brew.git synced 2026-06-12 23:55:28 +00:00
🍺 The missing package manager for macOS (or Linux) https://brew.sh
  • Ruby 93%
  • Shell 4.7%
  • Roff 1.7%
  • HTML 0.4%
Find a file
2026-06-12 21:17:36 +00:00
.claude Run brew lgtm on stop in AI hooks 2026-06-10 13:13:51 +01:00
.codex codex/hooks: return JSON. 2026-06-12 08:19:20 +01:00
.cursor chore: use ./bin/brew instead of system brew 2026-02-26 01:12:54 -06:00
.devcontainer devcontainer: install bash-completion 2026-05-09 01:49:43 +08:00
.github build(deps): bump the github-actions group across 1 directory with 2 updates 2026-06-12 08:11:23 +00:00
.licenses/bundler Update RubyGems licence metadata for bundler. 2026-06-12 08:18:11 +00:00
.sublime edit: enable Sublime Text project view 2021-08-01 15:36:48 -07:00
.vscode Enable strict typing in Library/Homebrew/rubocops/ 2026-03-30 20:04:55 -07:00
bin extend/os/linux/cask/config: actually use XDG_DATA_HOME 2026-04-11 13:51:43 -04:00
completions Update manpage and completions. 2026-06-12 16:18:27 +00:00
docs Update manpage and completions. 2026-06-12 16:18:27 +00:00
Library Limit sandbox home deny rules 2026-06-12 21:57:07 +01:00
manpages Update manpage and completions. 2026-06-12 16:18:27 +00:00
package Add as-console-user command 2026-05-20 19:35:06 +01:00
.dockerignore Improve Docker cache reuse 2026-05-04 09:21:18 +01:00
.editorconfig Delete ancient 'managing PRs' flowchart 2024-02-05 01:47:55 +01:00
.gitattributes Check RubyGems licences 2026-05-19 11:47:11 +01:00
.gitignore Run brew lgtm on stop in AI hooks 2026-06-10 13:13:51 +01:00
.shellcheckrc .shellcheckrc: disable unneeded check SC2310-SC2312 globally 2021-11-08 23:50:54 +08:00
.vale.ini Lint Ruby docs. 2024-05-01 11:35:21 +02:00
AGENTS.md Tighten pinned upgrade previews 2026-06-12 08:24:17 +01:00
CHANGELOG.md Add link to Homebrew blog in CHANGELOG.md 2020-07-26 22:43:22 -04:00
CLAUDE.md Add CLAUDE.md 2026-02-02 12:30:22 -05:00
CODEOWNERS Remove PLC references 2026-06-06 11:43:48 +01:00
CONTRIBUTING.md Add Responsible AI Usage documentation 2026-06-11 09:23:57 +01:00
Dockerfile Merge branch 'main' into move-to-ubuntu24.04 2026-06-07 11:37:42 +01:00
LICENSE.txt license: remove copyright ending year 2017-01-03 18:13:36 +00:00
README.md Update sponsors. 2026-06-12 08:11:52 +00:00

🍺 Homebrew

Latest GitHub release BSD-2-Clause License GitHub Sponsors Open Collective backers and sponsors

See Homebrew's homepage at brew.sh for installation instructions, what homebrew does, packages, brew bundle and more.

Homebrew install demo

💸 Donations

Homebrew is a non-profit project run entirely by volunteers, not employees. We need your funds to pay for software, hardware and hosting around continuous integration and future improvements to the project. Every donation will be spent on making Homebrew better for our users.

Please consider a regular donation through GitHub Sponsors, Open Collective or Patreon. Homebrew is fiscally hosted by the Open Source Collective.

📚 Documentation

Read the Homebrew manual with man brew.

Read installation, troubleshooting, contribution including the FAQ on docs.brew.sh.

Read the Homebrew Blog for release notes, project updates and announcements.

📦 Packages

Find formulae, casks, dependencies, versions and package metadata on formulae.brew.sh.

View anonymised install, build and operating system usage data at formulae.brew.sh/analytics. Read how Homebrew uses Anonymous Analytics.

🔧 Get Help

First, please run brew update and run (and read) brew doctor.

Second, read the Troubleshooting Checklist.

If you don't read these it will take us far longer to help you with your problem.

After this, if you still need help, please ask in Homebrew/discussions or follow (and read) the Homebrew/brew new issue chooser.

💬 Social

Follow Homebrew on Mastodon, Bluesky, 𝕏 (Twitter) or subscribe to the newsletter.

🤝 Contributing

We'd love you to join us and >10,000 others by contributing to Homebrew!

First, please read our Contribution Guide and Code of Conduct.

A good starting point for contributing is:

  • brew tap --force homebrew/core or brew tap --force homebrew/cask (depending on whether you'd rather work on formulae or casks)
  • perform a strict audit on a package you use e.g. brew audit --strict ffmpeg for FFmpeg
  • if no warnings, run brew audit --strict to run on all packages and pick one to fix
  • read through the warnings and fix them until brew audit --strict <package> shows no results
  • submit a pull request with your fixes

Alternatively, for something more substantial, check out one of the open issues in Homebrew/brew, Homebrew/homebrew-core or Homebrew/homebrew-cask.

If you've had inspiration for a new feature or bug fix: we don't need you to open an issue first, just open a pull request with your implementation and we'll review it.

Good luck!

🔐 Security

Please see our security policy for how to report security issues and what is in scope.

👥 Who We Are

Homebrew's Project Leader is Mike McQuaid.

Homebrew's Lead Maintainers are Bevan Kay, Bo Anderson, Branch Vincent, Carlo Cabrera, Dustin Rodrigues, FX Coudert, Issy Long, Justin Krehel, Michael Cho, Michka Popoff, Mike McQuaid, Nanda H Krishna, Patrick Linnane, Rui Chen, Ruoyu Zhong, Sam Ford, Sean Molenaar and Thierry Moisan.

Homebrew's other Maintainers are Anton Melnikov, Caleb Xu, Daeho Ro, Douglas Eichelberger, Eric Knibbe, Klaus Hipp, Markus Reiter, Rylan Polster, Štefan Baebler and William Woodruff.

Homebrew was originally created by Max Howell.

📜 License

Code is under the BSD 2-clause "Simplified" License. Documentation is under the Creative Commons Attribution license.

💛 Sponsors

Our macOS continuous integration infrastructure is hosted by MacStadium's Orka.

Powered by MacStadium

Secure password storage and syncing is provided by 1Password for Teams.

1Password

https://brew.sh's DNS is resolving with DNSimple.

DNSimple DNSimple

Homebrew is generously supported by Joshua Baer, Randy Reddig, Codecademy, b.well, Workbrew, GitHub, Custom Ink, Naveen Nathan, SAP, ZachryWilsn, mikadelbert and many other users and organisations via GitHub Sponsors.

GitHub