CheatPress

Homebrew Package manager

Version 7.0.9 · source

Homebrew, Postcard, light preview Light · Postcard 102 × 152 mm · PDF Homebrew, Postcard, dark preview Dark · Postcard 102 × 152 mm · PDF Homebrew, Postcard, ink saver preview Ink saver · Postcard 102 × 152 mm · PDF
Homebrew, A5, light preview Light · A5 148 × 210 mm · PDF Homebrew, A5, dark preview Dark · A5 148 × 210 mm · PDF Homebrew, A5, ink saver preview Ink saver · A5 148 × 210 mm · PDF
Homebrew, A4, light preview Light · A4 210 × 297 mm · PDF Homebrew, A4, dark preview Dark · A4 210 × 297 mm · PDF Homebrew, A4, ink saver preview Ink saver · A4 210 × 297 mm · PDF
Homebrew, A4 landscape, light preview Light · A4 landscape 297 × 210 mm · PDF Homebrew, A4 landscape, dark preview Dark · A4 landscape 297 × 210 mm · PDF Homebrew, A4 landscape, ink saver preview Ink saver · A4 landscape 297 × 210 mm · PDF
Homebrew, A3, light preview Light · A3 297 × 420 mm · PDF Homebrew, A3, dark preview Dark · A3 297 × 420 mm · PDF Homebrew, A3, ink saver preview Ink saver · A3 297 × 420 mm · PDF
Homebrew, A3 landscape, light preview Light · A3 landscape 420 × 297 mm · PDF Homebrew, A3 landscape, dark preview Dark · A3 landscape 420 × 297 mm · PDF Homebrew, A3 landscape, ink saver preview Ink saver · A3 landscape 420 × 297 mm · PDF
Homebrew, Letter, light preview Light · Letter 8.5 × 11 in · PDF Homebrew, Letter, dark preview Dark · Letter 8.5 × 11 in · PDF Homebrew, Letter, ink saver preview Ink saver · Letter 8.5 × 11 in · PDF
Homebrew, Tabloid, light preview Light · Tabloid 11 × 17 in · PDF Homebrew, Tabloid, dark preview Dark · Tabloid 11 × 17 in · PDF Homebrew, Tabloid, ink saver preview Ink saver · Tabloid 11 × 17 in · PDF

Start here

brew update
Refresh Homebrew itself
brew search <text>
Find a formula or cask
brew info <name>
Read details first
brew install <name>
Install a package
brew list
See what is installed
brew upgrade
Upgrade everything outdated
brew uninstall <name>
Remove a package
brew cleanup
Free old versions and cache

Concepts

  1. Taps homebrew-core, cask
  2. Formula or cask recipe
  3. Cellar versioned files
  4. Prefix bin on your PATH

Install and remove

brew install <formula>
Install a command-line package
brew install --cask <cask>
Install a GUI app
brew uninstall <name>
Remove a package
brew reinstall <name>
Remove and install again
brew install -n <name>
Dry run, change nothing
brew install --build-from-source <formula>
Compile instead of using a bottle
Dependencies still come as bottles when available.
brew install --HEAD <formula>
Build the upstream development version
brew uninstall --zap --cask <cask>
Also remove app support files
brew uninstall --ignore-dependencies <name>
Remove even if others need it
brew install --only-dependencies <formula>
Install just the dependencies

Update and upgrade

brew update
Fetch latest formulae and casks
brew outdated
List packages with newer versions
brew upgrade
Upgrade all outdated packages
brew upgrade <name>
Upgrade one package
brew upgrade -n
Preview what would upgrade
brew upgrade --cask --greedy
Include casks that self-update
Casks marked auto-updates or version latest are skipped without --greedy.
brew outdated --json=v2
Machine-readable outdated list
brew pin <formula>
Hold at the current version
brew unpin <formula>
Allow upgrades again
brew list --pinned
Show pinned formulae

Search and inspect

brew search <text>
Search formulae and casks
brew search --desc <text>
Search descriptions too
brew info <name>
Version, deps, caveats, install state
brew list
List installed formulae and casks
brew list --versions
Show installed versions
brew list --cask
List installed casks only
brew leaves
Packages you installed directly
brew desc <name>
One-line description
brew deps --tree <name>
Dependency tree
brew uses --installed <name>
Installed packages needing this
brew home <name>
Open the project homepage
brew info --json=v2 --installed
Installed state as JSON
brew log <name>
Recent changes to a formula

Services

brew services list
Services and their status
brew services start <formula>
Run now and at login/boot
brew services stop <formula>
Stop and unregister
brew services restart <formula>
Stop and start again
brew services run <formula>
Run now, not at login/boot
sudo brew services start <formula>
System-wide service as root
brew services cleanup
Remove unused service files

Taps

brew tap
List added taps
brew tap <user>/<repo>
Add a third-party repository
brew untap <user>/<repo>
Remove a tap
brew tap-info <user>/<repo>
Show tap details
brew install <user>/<repo>/<formula>
Install from a tap in one step

Cleanup and doctor

brew cleanup
Delete old versions and stale downloads
brew cleanup -n
Show what cleanup would delete
brew autoremove
Remove unneeded dependencies
brew doctor
Diagnose common problems
brew config
Print setup info for bug reports
brew cleanup --prune=<days>
Also drop cache older than N days
brew --prefix
Show the install prefix
brew --cache
Show the download cache path
brew missing
Check for missing dependencies
brew link <formula>
Link a formula into the prefix
brew unlink <formula>
Unlink but keep installed

Brewfile (bundle)

brew bundle dump
Write installed state to Brewfile
brew bundle
Install everything in the Brewfile
brew bundle check
Are all entries satisfied?
brew bundle list
List what the Brewfile declares
brew bundle cleanup
Show extras not in the Brewfile
Only previews; add --force to actually uninstall them.
brew bundle cleanup --force
Uninstall everything not listed
brew bundle --file=<path>
Use a specific Brewfile
brew bundle --global
Use the global Brewfile
brew bundle dump --force
Overwrite an existing Brewfile
Brewfile
tap "<user>/<repo>"brew "<formula>"cask "<cask>"

Recipes

Weekly maintenance
brew updatebrew outdatedbrew upgradebrew autoremovebrew cleanup
Capture and restore a setup
brew bundle dump --file=~/Brewfile# on the new machinebrew bundle --file=~/Brewfile
Why is this installed?
brew leaves | grep <name>brew uses --installed <name>brew deps --tree <name>
Hold one package back
brew pin <formula>brew upgrade   # skips itbrew unpin <formula>