Limpeza do Homebrew: como liberar o espaço que o brew ocupa no Mac

O Homebrew guarda as versões antigas do que você atualiza e um cache do que baixa, então vai crescendo aos poucos. O brew cleanup remove versões antigas e downloads com mais de 120 dias; o brew cleanup --prune=all esvazia por completo o cache de downloads; o brew autoremove desinstala as dependências de que mais nada precisa. Os três são comandos oficiais, e nenhum deles toca na versão atual de algo que você usa.

Os comandos e valores padrão abaixo vêm do manual do Homebrew, em outubro de 2026 (Homebrew 7).

Onde o Homebrew guarda seus arquivos

O macOS 27 Golden Gate só roda em Apple silicon, então as instalações novas usam /opt/homebrew. Os Macs Intel, que ficam no macOS 26 Tahoe ou anterior, continuam usando /usr/local. Um Mac migrado de um modelo Intel pode ter os dois; o brew --prefix mostra qual está ativo.

Os apps instalados como cask ficam em /Applications, como qualquer outro app.

Meça antes de limpar

du -sh "$(brew --cache)"
du -sh "$(brew --cellar)"
du -sh "$(brew --cellar)"/* | sort -h | tail -20

As duas primeiras linhas mostram o tamanho do cache de downloads e de todas as fórmulas instaladas. A terceira lista as 20 maiores fórmulas. Cada pasta dentro do Cellar contém uma subpasta por versão instalada, então o brew list --versions mostra quais fórmulas têm mais de uma.

brew cleanup: o que remove e o que mantém

brew cleanup -n
brew cleanup

O brew cleanup -n (ou --dry-run) lista cada arquivo que seria removido e termina com uma estimativa do espaço que seria liberado. Nada é apagado. Depois, o brew cleanup simples:

• remove as versões antigas das fórmulas instaladas, mantendo a atual;
• remove arquivos de bloqueio obsoletos e downloads desatualizados de fórmulas e casks;
• remove qualquer download com mais de 120 dias. A variável HOMEBREW_CLEANUP_MAX_AGE_DAYS muda esse número.

Por padrão, ele também remove as dependências que não são mais necessárias, como o brew autoremove, a menos que você defina HOMEBREW_NO_AUTOREMOVE.

Para limpar uma única fórmula ou cask, informe o nome: brew cleanup node.

Indo além com –prune

brew cleanup --prune=all

O --prune recebe um número de dias e remove todos os arquivos de cache mais antigos que isso; o --prune=all os remove seja qual for a idade. O -s (--scrub) também remove os downloads das versões mais recentes, mas ainda mantém os downloads das fórmulas e casks instalados no momento. A própria ajuda do Homebrew observa que rm -rf "$(brew --cache)" remove até esses. O cache só guarda downloads, então qualquer uma dessas opções é segura; o Homebrew baixa de novo o que precisar.

Todas essas exclusões são definitivas: nada vai para o Lixo.

Limpeza automática

O Homebrew já faz uma certa limpeza por conta própria. Depois de brew install, brew upgrade e brew reinstall, ele limpa as fórmulas envolvidas e, a cada 30 dias (HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS), limpa tudo. Se você definir HOMEBREW_NO_INSTALL_CLEANUP no perfil do shell, isso nunca acontece, o que explica um Cellar cheio de versões antigas. Remova a variável ou execute brew cleanup de vez em quando. Para proteger fórmulas específicas, liste-as em HOMEBREW_NO_CLEANUP_FORMULAE.

Remova as dependências de que nada precisa

Quando você desinstala uma fórmula, as bibliotecas que ela trouxe podem ficar para trás.

brew autoremove -n
brew autoremove

O brew autoremove desinstala as fórmulas que foram instaladas só como dependências e de que mais nada precisa. A versão com -n mostra a lista antes.

Desinstale o que você não usa mais

brew leaves --installed-on-request
brew uninstall <formula>

O brew leaves lista as fórmulas das quais nada mais depende, e o --installed-on-request (-r) restringe a lista às que você mesmo instalou. Normalmente é a lista mais curta para revisar. Desinstalar uma fórmula a remove do Cellar de vez; reinstalá-la exige baixá-la de novo.

Casks e –zap

brew uninstall --cask <cask>
brew uninstall --zap <cask>

Uma desinstalação normal remove o app. O --zap também remove os arquivos que a definição do cask lista como pertencentes ao app, como preferências, caches e pastas de suporte em ~/Library. O manual do Homebrew avisa que ele pode remover arquivos compartilhados entre aplicativos, então use-o só para apps que você tem certeza de que quer eliminar junto com os ajustes. Para apps que não foram instalados pelo Homebrew, veja como desinstalar apps do Mac por completo.

Antes de desinstalar, veja o que depende da fórmula

brew uses --installed <formula>

Esse comando lista as fórmulas e os casks instalados que precisam daquela que você vai remover. Se a lista não estiver vazia, o Homebrew se recusa a desinstalá-la, a menos que você acrescente --ignore-dependencies, o que pode quebrar esses pacotes. Em geral, é melhor deixar as bibliotecas compartilhadas em paz e deixar o brew autoremove recolhê-las quando nada mais precisar delas.

Por que o Homebrew pode continuar grande depois da limpeza

A limpeza remove sobras, e não os pacotes que você usa. Toolchains, compiladores e frameworks grandes são pesados por natureza, e cada um pode trazer dezenas de dependências. Se o Cellar continuar grande, o terceiro comando du acima mostra quais fórmulas dominam. Desinstale as que você não usa mais e depois execute brew autoremove para que as dependências delas também saiam.

Confira o resultado

brew doctor

O brew doctor verifica se há possíveis problemas na instalação e termina com um erro se encontrar algum. A maioria dos avisos é só informativa, mas é um bom passo final depois de uma limpeza ou de uma migração para um Mac novo.

Como o MoreRoom ajuda

A versão gratuita do MoreRoom reconhece o cache de downloads e o Cellar do Homebrew e mostra o tamanho de cada um. O cache de downloads é marcado como “Seguro remover” e o Cellar como “Revisar antes”. Quando você limpa qualquer um deles, o MoreRoom executa o próprio comando do Homebrew, brew cleanup --prune=all, que remove versões antigas e downloads em cache, mas nunca os pacotes que você usa. Esse comando é definitivo e está sinalizado como tal. O MoreRoom não desinstala fórmulas nem casks por você; para isso, use brew uninstall.

O Pro acrescenta o Coletor, para limpar vários itens de uma vez, e o modo meta, que escolhe a seleção mais segura para o espaço de que você precisa.