Skip to content
jacknagel edited this page Apr 28, 2012 · 67 revisions

Use man brew to view the manpage.

Command Description
brew --cache Print path to Homebrew’s download cache (usually /Library/Caches/Homebrew)
brew --cellar Print path to Homebrew’s Cellar (usually /usr/local/Cellar)
brew --config Print system configuration info
brew --env Print Homebrew’s environment
brew --prefix Print path to Homebrew’s prefix (usually /usr/local)
brew --prefix <formula> Print where formula is installed
brew --version Print Homebrew’s version number
brew audit [<formula>] Audit formula (or all formulae) for common code and style issues
brew cleanup <formula> Remove older versions from the Cellar for all (or specific) formulae1
brew create <url> Generate formula for downloadable file at url and open it in $HOMEBREW_EDITOR or $EDITOR2
brew create [--fink] [--macports] <formula> Open the Fink/MacPorts search page in your browser, so you can see how they do formula
brew deps <formula> List dependencies for formula
brew doctor Check your Homebrew installation for common issues
brew edit Open all of Homebrew for editing in TextMate
brew edit <formula> Open in $HOMEBREW_EDITOR or $EDITOR
brew fetch [--force] [--HEAD] <formula> Download source package for formula; for tarballs, also prints MD5, SHA1, and SHA256 checksums
brew home Open Homebrew’s homepage in your browser
brew home <formula> Opens formula ’s homepage in your browser
brew info Print summary of installed packages
brew info <formula> Print info for formula (regardless of whether formula is installed)
brew info --github <formula> Open Github’s history page for formula in your browser
brew install <formula> Install formula
brew install --HEAD <formula> Install the HEAD version of formula (if its formula defines HEAD)
brew link <formula> Symlink all installed files for formula into the Homebrew prefix3
brew list [<formula>] List all installed files for formula (or all installed formulae with no arguments)
brew options <formula> Display install options specific to formula
brew outdated List formulae that have an updated version available
brew prune Remove dead symlinks from Homebrew’s prefix4
brew remove <formula> Uninstall formula
brew search List all available formula
brew search <formula> Search for formula in all available formulae
brew search /<formula>/ Search for /formula/ (as a regexp) in all available formulae
brew tap [<tap>] Tap a new formula repository from GitHub, or list existing taps.
brew test <formula> If formula defines a test, run it
brew untap <tap> Remove a tapped repository.
brew unlink <formula> Unsymlink formula from Homebrew’s prefix
brew update Update formulae and Homebrew itself
brew upgrade Install newer versions of outdated packages
brew upgrade <formula> Install newer version of formula
brew versions <formula> List previous versions of formulae, along with a command to checkout each version

1 To remove a specific version, just cd to the directory in the Cellar and rm -rf it.

2 Homebrew tries to guess the formula name and version. If it fails, you’ll have to make your own template. I suggest copying wget ’s.

3 Symlinking is automatically performed when installing formulae. It’s useful for DIY installation, or swapping out versions of a package that has multiple installs.

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

Clone this wiki locally