Homebrew is a package manager for macOS and Linux that provides an easy interface to install many packages. It has been built to play nicely with your existing system and not interfere with it. It has been built entirely on top of git and ruby and is easily customized to suit your needs. Debugging help with Homebrew should at the very least include details of the output of `brew doctor`.

Homebrew is a package manager for macOS and linux. It can be installed by following the instructions on its website.

It provides an easy interface to install many packages. A list of the available packages is online. Alternatively you can use the search feature to find the name of a package.

$ brew search vim
macvim          vim             vimpc
pacvim          vimpager
Caskroom/cask/macvim            Caskroom/cask/vimr

Installation is as easy as

$ brew install macvim

and Homebrew will take care of installing all of the necessary dependencies.

Debugging Homebrew Issues

Homebrew has very good documentation on debugging issues you may have. The key to it all is the brew doctor command which will check for any potential issues your system may have.

Homebrew Documentation

Homebrew contains a lot of documentation including an FAQ and Tips N' Tricks section.

There is also offline support available via the man brew and brew help commands.

Homebrew Manual

More information on all of the functions of brew is available via the Terminal with:

$ man brew

...or brew help, which will provide a brief overview of some of the more common functions available:

Example usage:
  brew search [TEXT|/REGEX/]
  brew info [FORMULA...]
  brew install FORMULA...
  brew update
  brew upgrade [FORMULA...]
  brew uninstall FORMULA...
  brew list [FORMULA...]

Troubleshooting:
  brew config
  brew doctor
  brew install --verbose --debug FORMULA

Contributing:
  brew create [URL [--no-fetch]]
  brew edit [FORMULA...]

Further help:
  brew commands
  brew help [COMMAND]
  man brew
  https://docs.brew.sh
history | excerpt history