Sobre o projeto
TidyMyMac é um utilitário open-source de limpeza de armazenamento para macOS, direcionado a desenvolvedores. Ele verifica, revisa e recupera espaço em disco a partir do terminal, com transparência e segurança como objetivos de design declarados: inspecionar primeiro, revisar antes de excluir, modo de simulação por padrão e permanecer nativo do terminal.
Os recursos listados no README incluem uma TUI interativa para navegar e selecionar o que limpar, seleção por item na tela de revisão (desmarcar um único download, imagem/contêiner/volume Docker, backup iOS ou snapshot do Time Machine para aquela execução), um filtro de barra e selecionar/desmarcar tudo, modo de simulação por padrão, caminhos protegidos que nenhum limpador pode tocar independentemente de flags, limpadores modulares, perfis nomeados agrupando categorias e diretórios de projeto, relatórios de progresso e resumos de espaço recuperado, exportação JSON ou CSV dos resultados de verificação, geração de scripts de limpeza para shell e direcionamento de categorias específicas em qualquer comando.
O README motiva a ferramenta observando que o macOS acumula armazenamento em locais difíceis de inspecionar, como caches, artefatos de desenvolvedor, logs e a vaga categoria System Data.
Os limpadores cobrem: arquivos temporários (/tmp, /var/tmp, diretórios temporários do usuário); caches de aplicativos (~/Library/Caches); logs do sistema (~/Library/Logs, /Library/Logs, /var/log); cache do Homebrew; artefatos Docker (contêineres parados, imagens sem tag, volumes órfãos); backups iOS; resíduos e instaladores antigos de atualizações do macOS; arquivos de instalação (.dmg, .pkg) e itens grandes em ~/Downloads; órfãos de aplicativos desinstalados; DerivedData do Xcode, arquivos e simuladores; caches de build e módulos do Go; artefatos de projeto como node_modules, dist, target e .venv, além de arquivos acima de 500MB nos caminhos de projeto do perfil; snapshots locais do Time Machine; e a Lixeira.
As opções de instalação documentadas são um script de instalação via curl (instalando em /usr/local/bin, com fallback para $HOME/.local/bin, com prompt de sudo), um tap do Homebrew, go install e compilação a partir do código-fonte com make build. O README afirma que Go 1.26+ é necessário.
O uso centra-se em comandos: scan (tabela interativa por padrão, seleção de categoria, verificação de perfil, saída JSON/CSV/tabela, saída detalhada, --print-all, --save, --generate-script, --quiet); clean (modo de simulação padrão, --execute para excluir, seleção de categoria ou perfil, --include-large-files, --from-file, saída JSON, --prompt-sudo); profile (create, add-category, add-path, list, remove-path, delete); protect/unprotect e list protected; além de version, explain, list categories e history.
Notas de segurança: modo de simulação por padrão, exclusão apenas com --execute, caminhos protegidos como bloqueio rígido não anulável por flags de CLI, proteção embutida para armazenamentos de modelos de IA (~/.ollama/models e ~/.cache/huggingface) mesmo sem arquivo de configuração, sem operações silenciosas e erros não fatais.
A configuração reside em um ~/.tidymymac/config.yaml opcional, cobrindo caminhos protegidos, categorias desabilitadas por padrão e perfis. A documentação de solução de problemas observa que um terminal sem Acesso Total ao Disco no macOS pode fazer a Lixeira e algumas categorias reportarem 0 B. O projeto é licenciado sob MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.