Contribuição open source · Shell · Go · macOS · CLI
tw93/
Ferramenta de código aberto para Mac que limpa caches, desinstala apps com seus resíduos, faz manutenção, analisa o disco e monitora o sistema pelo terminal.
- 6 PRs em revisão
- 69,9k estrelas no GitHub
- 11/10/2026 primeiro PR
O projeto
O Mole é uma ferramenta de linha de comando gratuita e de código aberto que reúne o que no Mac costuma exigir apps como CleanMyMac, AppCleaner, DaisyDisk e iStat Menus: limpeza de caches e resíduos, desinstalação de apps com seus arquivos, manutenção do sistema, análise do disco e monitoramento em tempo real. Funciona em Macs Intel e Apple Silicon a partir do macOS 12.
Como pode apagar arquivos, o Mole valida caminhos, protege locais do sistema e pastas compartilhadas, pede confirmação quando a ação exige e pula o que não consegue provar que é seguro alterar. As limpezas podem ser simuladas antes, a atividade fica registrada para consulta posterior e a instalação é feita pelo Homebrew ou por um script oficial.
Como cada PR foi feito
-
Um problema por PR
Cada PR resolve uma coisa só, com a menor mudança possível. Isso simplifica a revisão, reduz o risco de efeito colateral e permite desfazer uma mudança sem levar outras junto.
-
O problema vira teste
As correções chegam com testes automatizados que cobrem o caso que falhava, para o problema não voltar sem que ninguém perceba.
-
Os critérios do próprio projeto
Formatação, análise estática e a suíte completa de testes rodam na integração contínua do projeto, e a mudança só entra depois da revisão do mantenedor.
-
Escrito para quem revisa
A descrição de cada PR explica o problema, a mudança e como ela foi testada, para o mantenedor decidir com segurança.
Cada PR, em linguagem de negócio
Estes PRs estão em revisão pelos mantenedores e ainda não foram incorporados. Clique em um deles para ver o problema, a proposta e o valor esperado.
-
#1727aberto em 11/10/2026Em revisão Limpeza de itens recentes nas versões atuais do macOS A limpeza de itens recentes do Mole só reconhece os formatos antigos dessas listas e não as apaga nas versões atuais do macOS; a correção proposta inclui os formatos novos.
- O problema
- A limpeza do Mole inclui apagar as listas de aplicativos, documentos, servidores e computadores da rede acessados recentemente que o macOS mantém. Ela só reconhece os formatos antigos desses arquivos, e do macOS 13 (Ventura) em diante o sistema grava essas listas em formatos novos, então elas continuam intactas depois da limpeza.
- O que o PR propõe
- O PR acrescenta os nomes exatos dessas listas nos dois formatos novos, mantendo os antigos. A limpeza continua restrita a esses arquivos conhecidos e passa pelas mesmas verificações de segurança de antes, e o teste da rotina é ampliado para conferir cada formato pelo nome.
- Valor esperado
- Com a mudança, quem usa a limpeza para apagar o histórico de itens recentes obtém esse resultado também nas versões atuais do macOS, e não só nas antigas.
-
#1726aberto em 11/10/2026Em revisão Desinstalação do Xcode sem sobras do visionOS Ao desinstalar o Xcode, o Mole deixa para trás os dados de depuração do visionOS porque a Apple mudou o nome da pasta; o PR inclui o nome oficial na lista de limpeza.
- O problema
- Ao desinstalar o Xcode, o Mole também remove os dados de depuração que o Xcode guarda para cada plataforma da Apple e que podem ser gerados de novo quando necessário. A lista cobre iOS, macOS, watchOS, tvOS e o nome provisório da fase de testes do visionOS, mas não o nome oficial usado desde o Xcode 15.2, e essa pasta fica para trás no disco.
- O que o PR propõe
- O PR acrescenta a pasta com o nome oficial do visionOS à mesma lista, sob as mesmas regras: só entram dados recriáveis, e continuam preservados os dados e preferências do usuário, os pacotes de apps gerados para distribuição, as ferramentas de compilação instaladas e os simuladores. O teste de segurança da desinstalação também é estendido a essa pasta.
- Valor esperado
- Com a mudança, quem desenvolve para o Apple Vision Pro e remove o Xcode pelo Mole recebe o mesmo tratamento das outras plataformas da Apple, sem que a remoção vá além de dados recriáveis.
-
#1725aberto em 11/10/2026Em revisão Painel de status sem travar à espera da bateria A consulta de bateria do painel de status do Mole não tem prazo e pode congelar as atualizações se o serviço do macOS travar; a correção proposta limita essa consulta a um segundo, como as demais.
- O problema
- O painel de status do Mole mostra em tempo real CPU, memória, disco, rede, energia e processos. Todas as leituras têm prazo máximo para responder, menos a consulta de bateria feita ao macOS. Como a atualização completa espera todas as leituras terminarem, um travamento nesse serviço do sistema pode fazer os números do painel pararem de atualizar, sem prazo para voltar.
- O que o PR propõe
- A correção proposta dá à consulta de bateria um limite de um segundo, no mesmo padrão das outras leituras. Se o serviço não responder a tempo, a bateria fica de fora daquela atualização e o restante do painel segue normalmente. Um teste novo confirma que a consulta sai com esse prazo definido.
- Valor esperado
- Com a mudança, um serviço do macOS lento ou travado deixa de congelar o monitoramento: no pior caso, a informação da bateria fica de fora enquanto o serviço não responde.
-
#1724aberto em 11/10/2026Em revisão Itens de inicialização quebrados sem passar despercebidos A auditoria dos programas que o macOS inicia em segundo plano lê o campo errado em algumas configurações e não avisa sobre itens que apontam para um programa apagado; a correção proposta segue a regra do próprio macOS.
- O problema
- Na manutenção, o Mole avisa quando um programa configurado para rodar em segundo plano ao entrar na conta aponta para um arquivo que não existe mais. Quando a configuração traz o caminho completo do programa e, em outro campo, só o nome do comando, a auditoria lê o nome, conclui que não há caminho a conferir e deixa sem aviso um item cujo programa foi apagado.
- O que o PR propõe
- A correção proposta lê primeiro o campo com o caminho completo, que é o que o macOS usa para iniciar o programa, e só recorre ao outro quando ele não existe, a mesma ordem já usada pela desinstalação do Mole. Os itens quebrados continuam apenas relatados, sem remoção automática, e um teste novo reproduz esse tipo de configuração.
- Valor esperado
- Com a mudança, o relatório de manutenção deixa de tratar como saudável um item que aponta para um programa apagado, e a pessoa fica sabendo o que revisar. O item continua no lugar até ela decidir o que fazer.
-
#1723aberto em 11/10/2026Em revisão Instalação no Mac sem risco de usar a versão de Windows Quando a versão mais recente publicada é a de Windows, o instalador do Mac pode adotá-la e falhar no download; com a correção proposta, ele só aceita versões de Mac nessa consulta.
- O problema
- O Mole publica as versões de Mac e de Windows no mesmo repositório do GitHub. O script de instalação pergunta ao GitHub qual é a versão mais recente e, se a resposta for uma versão de Windows, aceita sem conferir e pula a busca alternativa que já descartava essas versões, o que leva a erros no download dos arquivos de Mac.
- O que o PR propõe
- A correção proposta faz o instalador conferir o nome da versão devolvida pelo GitHub e aceitar só o padrão usado nas versões de Mac. Se a resposta vier vazia ou for uma versão de Windows, o instalador recorre à busca alternativa, que já fazia essa filtragem. Dois testes novos cobrem a recusa da versão de Windows e a aceitação da versão de Mac.
- Valor esperado
- Com a mudança, quem instala o Mole no Mac pelo script deixa de depender da ordem em que as versões de Mac e de Windows são publicadas, e as duas formas de descobrir a versão mais recente seguem a mesma regra.
-
#1722aberto em 11/10/2026Em revisão Reparo das listas do Finder também no macOS 15 e posteriores A manutenção do Mole ignora o formato que o macOS usa desde o Sequoia nas listas de favoritos do Finder e de itens recentes; a correção proposta inclui esse formato na busca por arquivos corrompidos.
- O problema
- O comando de manutenção do Mole procura arquivos corrompidos entre as listas que o macOS usa para os favoritos do Finder e os documentos recentes, mas só reconhece os formatos antigos desses arquivos. A partir do macOS 15 (Sequoia), o sistema grava essas listas num formato mais novo, que fica fora da verificação, e o resultado pode dizer que está tudo saudável sem ter olhado para elas.
- O que o PR propõe
- A correção proposta acrescenta o formato novo à busca, com as mesmas regras de antes: só é removida a lista que falha na checagem de integridade feita pela própria ferramenta do macOS, e a lista de documentos recentes dos aplicativos continua fora do reparo. Um teste novo simula uma lista corrompida no formato novo e confirma o reparo.
- Valor esperado
- Com a mudança, quem usa o macOS 15 ou mais novo tem essas listas de fato verificadas, e o resultado da manutenção passa a refletir o que foi conferido.
Números atualizados em 11/10/2026.
O mesmo cuidado no seu sistema
Os mesmos hábitos destes PRs valem para backends que movimentam dinheiro: reproduzir o problema antes de corrigir, provar a correção com teste e não deixar dado sensível escapar.