Homebrew — The Missing Package Manager for macOS and Linux

What it is

Homebrew is the de facto package manager for macOS (and Linux). It installs CLI tools, libraries, and GUI applications (called casks) that Apple or your Linux distribution did not include. It is the first tool most developers install on a new Mac.

Homebrew targets developers, sysadmins, and power users who need to install and manage software beyond what the App Store or system package managers provide.

The project is actively maintained and suitable for both individual developers and teams looking to integrate it into their existing toolchain. Documentation and community support are available for onboarding.

How it saves time or tokens

Homebrew reduces software installation to a single command. Instead of downloading DMGs, dragging to Applications, and configuring PATH variables, you run brew install and the tool is ready. Homebrew also handles updates (brew upgrade), cleanup (brew cleanup), and dependency management automatically.

For teams evaluating multiple tools in the same category, the clear documentation and active community reduce the time spent on research and troubleshooting. Getting started takes minutes rather than hours of configuration.

How to use

1. Install Homebrew by pasting the install command from brew.sh into your terminal.
2. Use brew install <package> for CLI tools and brew install --cask <app> for GUI applications.
3. Keep everything updated with brew update && brew upgrade.
4. Search for packages with brew search <query> or browse formulae.brew.sh.

Example

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install common developer tools
brew install git node python3 go rust
brew install jq fzf ripgrep fd bat delta

# Install GUI apps via casks
brew install --cask visual-studio-code iterm2 docker firefox

# Update everything
brew update && brew upgrade && brew cleanup

# List installed packages
brew list --formula
brew list --cask

Related on TokRepo

• AI Tools for Coding — Developer tools that install via Homebrew.
• Featured Workflows — Browse curated developer setup and productivity workflows.

Common pitfalls

• Running brew update infrequently. Homebrew's package index goes stale quickly. Run brew update before installing new packages to get the latest versions.
• Using sudo brew on macOS. Homebrew is designed to run without root privileges. Using sudo can break permissions and cause hard-to-debug issues.
• Not cleaning up old versions. brew cleanup removes outdated downloads and old formula versions. Without periodic cleanup, your Homebrew cache can consume gigabytes of disk space.
• Not reading the changelog before upgrading. Breaking changes between versions can cause unexpected failures in production. Pin your version and review release notes.