homebrew cache cleanup / brew cache too large / clear brew downloads

Homebrew cache cleanup on macOS

Locate and clean stale Homebrew download and API caches while preserving important package roots.

Where storage typically grows

  • Homebrew keeps historical bottles and metadata over long periods.
  • Cache growth is gradual and often invisible until disk pressure appears.
  • Users may confuse cache paths with critical install roots.

Paths covered by Free Mac Space

  • /opt/homebrew/Caches
  • /usr/local/Homebrew/Caches
  • ~/Library/Caches/Homebrew

Recommended workflow

  1. 1.

    Scan Homebrew paths and sort by size.

  2. 2.

    Prioritize downloads and api cache subdirectories.

  3. 3.

    Avoid cleaning active package install roots such as Cellar or Caskroom.

  4. 4.

    Re-scan after cleanup to validate recovered space.

Safety boundary

Free Mac Space treats critical Homebrew install paths as protected guidance areas to reduce breakage risk.

FAQ

Does this remove installed formulas?+

No. The recommended workflow focuses on cache paths, not core package install roots.

Is Homebrew cleanup reversible?+

Cleanup-selectable paths are moved to Trash first, so short-term recovery remains available.

Can I keep a report for operations records?+

Yes. Exportable reports and local audit logs support change tracking.

Related deep-dive articles

Homebrew

Homebrew cache folders: small installs, surprisingly large history

Homebrew keeps download and metadata caches that can survive across upgrades. They are safe cleanup candidates when they become oversized.

Read article

Homebrew cache cleanup on macOS

Locate and clean stale Homebrew download and API caches while preserving important package roots.

Download Free Mac Space