The brew command

Eventually, you’ll be able to type “man brew”, but for now, this wiki entry may help you learn the ropes.

Command	Consequence
brew search	Lists all formula that you can install
brew search foo	Searches for foo in formula available to install
brew search /foo/	Same as above but parses /foo/ as a regex
brew install foo	Installs foo
brew list	Lists all installed formulae
brew list foo	Lists the installed files for foo
brew info --github foo	Open your browser at the Github History page for formula foo
brew info	Summarises all installed Homebrew packages
brew info foo	Gives all available information for installed or not installed formula foo
brew home	Open’s Homebrew’s homepage in your default browser
brew home foo	Opens foo’s homepage in your default browser
brew remove foo	Uninstalls foo
brew create [url]	Generates a formula for the downloadable file at url and opens it in TextMate 1
brew create url-of-tarball --cache	Generates a formula, then downloads the tarball. Adds the md5 to the formula template for you
brew create --macports foo	Open your browser at the macports package search page, so you can see how they do foo
brew edit foo	Opens the formula in TextMate
brew link foo	Symlinks all of foo’s installed files into the Homebrew prefix 2
brew unlink foo	Unsymlinks foo from the Homebrew prefix
brew prune	Removes dead symlinks from the Homebrew prefix 3
brew outdated	Shows formula that have an updated version available
brew --config	Print some useful system configuration to the console
brew --prefix	Display the real path to your Homebrew prefix (Usually /usr/local)
brew --cellar	Display the real path to your Homebrew Cellar (Usually /usr/local/Cellar)
brew doctor	Audits your installation for common issues

¹ Homebrew will attempt to automatically derive the formula name and version, if it fails, you’ll have to make your own template. I suggest copying wget’s.

² This is done automatically when you install formula. It is useful for DIY installation, or in cases where you want to swap out different versions of the same package that you have installed at the same time.

³ This is generally not needed. However, it can be useful if you are doing DIY installations.