Documentação

Visão geral

O Mole tem duas interfaces com categorias de limpeza parecidas e as mesmas regras conservadoras de segurança e listas de proteção, mas as capacidades não são idênticas. A CLI é gratuita, de código aberto e licenciada sob a GPL-3.0. O app para Mac é um acompanhante nativo em SwiftUI, com licença única de US$ 19, atualizações gratuitas e sem assinatura. Ele oferece uma interface gráfica para limpeza e manutenção do Mac; a CLI acrescenta alguns comandos que só existem no terminal.

App para Mac

Instalação

Baixe o DMG na página inicial, ou instale pelo Homebrew: brew install --cask mole-app.

Limpar (Terra)

Limpar começa pelos caches de apps, que incluem caches de navegadores e de clientes de nuvem e registros dos apps; ferramentas de desenvolvimento, de IA, de comunicação e de design têm grupos próprios. Depois vêm os resíduos de apps desinstalados e, em seguida, Dados do sistema: instantâneos locais do Time Machine, caches e registros do sistema, instaladores antigos do macOS e downloads antigos de papéis de parede. O Lixo vem por último. O grupo Gerenciar separadamente lista backups, arquivos locais do iCloud, máquinas virtuais e modelos, fora do total da limpeza.

Revise as linhas antes de limpar. Dados do sistema é uma classificação de armazenamento do macOS, não uma pasta nem um tamanho alvo: os arquivos medidos pelo Mole não vão bater com o número nos ajustes de Armazenamento. A medição que reconhece hardlinks evita contar arquivos compartilhados duas vezes. Os caches são excluídos de forma permanente por padrão, com uma opção de Lixo nos Ajustes; liberar instantâneos locais remove esses pontos de restauração locais, não os backups num disco externo. A limpeza opcional do log unificado do sistema é irreversível e exige a própria revisão.

Só com revisão, por padrão: caches de pacotes com custo real de reconstrução (npm, yarn, pnpm, bun, CocoaPods, Gradle) e saída gerada de projeto que pode ser reconstruída sem baixar dependências (build, dist, target, .build, .next, DerivedData, __pycache__, coverage). Diretórios de dependências baixadas, como node_modules, Pods e venv, não são oferecidos pelo app para Mac: reconstruí-los precisa de rede e pode não reproduzir o estado do lockfile. Itens só de revisão ficam desmarcados até você confirmar; os Ajustes podem mandar a limpeza passar pelo Lixo.

Uma ação à parte em Gerenciar separadamente pode recuperar espaço sem uso dentro de um disco virtual do Parallels compatível, pela própria ferramenta do Parallels. Desligue a VM normalmente antes; VMs suspensas ou em execução não entram. Revise a estimativa e confirme à parte. A ação conserva a VM e os arquivos dela, não entra na limpeza em lote e precisa terminar sem interrupção.

Limpeza e cuidado de IA (a Lua)

Quando este Mac guarda dados de ferramentas de IA, uma Lua distante aparece no canto superior direito da página Limpar e leva à Limpeza e cuidado de IA. A entrada só aparece quando esses dados são encontrados, a conferência só procura algumas pastas fixas e nunca percorre o disco, e Ajustes › Geral › Limpeza pode ocultá-la. A página não varre ao chegar; Analisar dados de IA é o que inicia, e uma varredura que encontra alguma coisa abre os resultados direto.

Os resultados vêm em três faixas, conforme o quanto uma remoção poderia doer. Caches e versões antigas começam selecionados: versões substituídas das ferramentas de linha de comando Claude Code, Codex, Cursor Agent, Grok e GitHub Copilot, inclusive as versões do cursor-agent que o app de desktop do Cursor guarda para si, e caches do Claude, do Codex, do Cursor e do Grok. Sessões e worktrees começam desmarcados: sessões do Codex, do Claude Code, do OpenCode e do Devin além de uma janela de retenção definida por ferramenta (15, 30, 90 ou 120 dias, ou Não listar, o padrão, sob o qual nenhuma sessão é listada e a linha mostra quantas sessões a ferramenta guarda e o tamanho delas, enquanto cada escolha mostra o que listaria), sessões do Claude Code além dessa janela cuja pasta de projeto já não existe, imagens que o Codex renderizou para sessões que ele já apagou, e worktrees que o git consegue provar não ter mudanças únicas nem commits que um branch não retenha. Ferramentas ociosas e manutenção começam desmarcadas: ferramentas de IA de linha de comando sem uso há 30 dias e que não estão em execução, desinstaladas com as sessões e os ajustes, compactação de bancos SQLite acima de 200 MB, e pastas de configuração deixadas por ferramentas já removidas. Versões antigas, caches, sessões e worktrees podem ser desmarcados uma entrada de cada vez.

Sessões usadas nas últimas 24 horas nunca são listadas, então a página funciona com o Codex e o Claude Code abertos. Dados que uma ferramenta em execução mantém abertos continuam listados como em uso e não podem ser selecionados, e cada linha é conferida de novo logo antes de se mover. Os arquivos vão para o Lixo; uma sessão do Codex é copiada para o Lixo e depois removida com o próprio comando do Codex, e as imagens que o Codex renderizou para ela vão para o Lixo junto; ferramentas instaladas pelo Homebrew são desinstaladas pelo brew; a compactação acontece no lugar. Memórias, planos e skills não estão em linha nenhuma, e dos modelos locais só os do Ollama aparecem, sem uso há um mês e removidos com o próprio ollama rm.

Apps (Marte)

Apps reúne atualizações de apps, gerenciamento de início e limpeza de desinstalação. A vista Atualizações confere apps do Sparkle, do Homebrew Cask e Formula e da Mac App Store, e depois instala as atualizações compatíveis no lugar ou abre a App Store quando o macOS exige essa passagem.

A vista Início lista Login Items, Launch Agents, Launch Daemons e itens em segundo plano. Você pode desativar entradas compatíveis, revelar os arquivos delas ou ir para os Ajustes do Sistema no caso de itens gerenciados pela Apple.

Para desinstalar, escolha os apps a remover. O Mole encontra arquivos que sobraram em mais de quinze subdiretórios de Library, entre eles Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State e Input Methods. As entradas do Dock são limpas automaticamente, e resíduos ambíguos ou com correspondência fraca continuam visíveis, mas desmarcados, para revisão. O Cmd-clique adiciona linhas a um lote de desinstalação, e qualquer falha de um app permanece na lista para tentar de novo.

As atualizações saem dentro do app quando dá: instalações do Sparkle e do Homebrew Cask rodam dentro do Mole; atualizações da Mac App Store passam pelo CommerceKit e caem para o app App Store em problemas de autorização ou de tempo esgotado; os outros apps são abertos para o próprio atualizador assumir.

Pacotes /Applications/*.app de propriedade de root pedem uma confirmação de administrador na primeira remoção de uma sessão; remoções seguintes reutilizam a mesma autorização até você sair do Mole. A vista Início liga e desliga itens de início e LaunchAgents / LaunchDaemons validados direto, quando consegue associá-los a um serviço estável do launchd; entradas gerenciadas pelo gerenciamento de tarefas em segundo plano do macOS que o Mole não controla direto são encaminhadas para o painel correspondente dos Ajustes do Sistema.

O Adobe Genuine Service tem uma ação de desinstalador oficial. O Mole abre o desinstalador instalado da Adobe quando consegue verificá-lo, ou oferece as instruções da Adobe quando não consegue. Ele confere o serviço de novo depois; só abrir o desinstalador não estabelece a remoção.

Otimizar (Mercúrio)

As tarefas de manutenção padrão rodam com um clique. Tarefas que não pedem administrador rodam em silêncio; tarefas de administrador são agrupadas atrás de um pedido, quando necessário.

Otimizar começa com uma passagem visível de correção para a troca de método de entrada, o Spotlight, a Central de Notificações e a Área de Transferência Universal. Tarefas mais fundas incluem: reconstruir o Quick Look; fazer vacuum em bancos SQLite; limpar o estado salvo dos apps, eventos de quarentena e o histórico de notificações; reparar preferências quebradas, listas de arquivos compartilhados e regras órfãs do Spotlight; auditar itens de início; mover para o Lixo Launch Agents cujo programa não existe; e executar a manutenção periódica.

Travas de segurança pulam tarefas quando as condições não são seguras. A redefinição do DNS e da pilha de rede não faz parte do conjunto padrão de manutenção.

Otimizar pula uma tarefa quando a própria verificação diz que ela é desnecessária, como a purga de memória enquanto a pressão da memória está saudável, ou a compactação dos bancos do Mail e do Mensagens enquanto esses apps estão em execução; as tarefas puladas listam um motivo no painel de resultado, para você ver o que rodou. Clique na linha de resumo sob Manutenção concluída para abrir Detalhes da otimização, que lista o que rodou, o que foi pulado e por quê.

Analisar (Júpiter)

Um mapa de blocos do disco inteiro. Entre em qualquer diretório para ver o tamanho em cada nível, com itens densos ou parecidos dobrados em blocos de resumo para o mapa continuar legível.

Entradas que não puderam ser medidas (pastas com permissão restrita, containers protegidos pelo TCC) aparecem com uma opção de tentar de novo, em vez de sumirem em silêncio. Raízes de navegação protegidas (/, /Users, /Applications) não podem ir para o Lixo. Os resultados da varredura de disco ficam em cache, então reabrir mostra o último resultado, e depois de 6 horas o Mole volta a medir em segundo plano.

Um clique num diretório no mapa de blocos entra nele; a barra de caminho acima do mapa volta para qualquer ancestral. A lista da esquerda e os blocos reais do mapa mantêm as ações do item: abrir ou mostrar no Finder, e clique direito para Mover para o Lixo, que move o item na hora, como o Finder, para poder ser colocado de volta; só itens que já estão no Lixo pedem confirmação antes, porque apagá-los é permanente. Blocos de resumo são só visão geral. A área do bloco no mapa é proporcional ao tamanho em bytes, então os maiores itens sempre desenham os maiores blocos.

O menu de contexto também copia o caminho de um arquivo ou de uma pasta, para colar no Finder ou numa mensagem de suporte sem remover o item.

Status (Sol)

O painel mostra Saúde, CPU, GPU, Memória, Bateria, Disco, Rede e Ventoinhas. Um Mac sem bateria mostra Temperatura no lugar de Bateria, e um Mac sem ventoinhas mostra Temperatura no lugar de Ventoinhas. Os gráficos de tendência mostram a atividade recente, e Macs compatíveis expõem controles de ventoinha para os modos Auto, Resfriar e Máx.

A lista de processos abaixo da grade atualiza a cada segundo. As cinco colunas (Nome, PID, CPU, Energia, Memória) ordenam no clique; clique de novo para inverter a direção. Clique numa linha para abrir a folha de explicação. Clique direito numa linha para Fixar linha/Desafixar linha (processos fixados ficam no topo entre atualizações e reinícios do app, para você acompanhar um app sem perdê-lo na rolagem), Encerrar (um pedido de saída normal, seguido de forçar encerramento se precisar) e Copiar caminho do executável. A linha de maior consumo no topo do cartão da Bateria leva direto a esse processo na folha de explicação.

Painel da barra de menus

Um monitor opcional, sempre visível, na barra de menus do macOS. Mostre o ícone, um corredor pequeno cujo movimento segue a carga do sistema, dados ao vivo, ou os dois. Escolha entre Mole, RunCat, Beagle, Poodle, Dinosaur, Horse, Rabbit, Frog, Chicken, Rubber Duck, Fishman, Pixel ou Flex. O painel mostra um destaque de Saúde (pontuação, chip, memória, macOS, tempo ligado), cartões de hardware, controles de ventoinha onde há suporte, os cinco processos que mais usam CPU e um resumo No total do que o Mole limpou, desinstalou e otimizou.

As ferramentas rápidas ficam na base do painel: indicadores de sinal de privacidade acendem quando a câmera ou o microfone está em uso, Manter tela ligada tem um menu de duração (1, 2, 4, 8 ou 12 horas, ou Até desativar), Limpar tela transforma a tela numa cor lisa para você limpar o monitor e o teclado, com um bloqueio opcional de entrada condicionado à permissão de Acessibilidade do macOS, e um botão Ejetar aparece ali quando um disco externo ou uma imagem de disco pode ser desmontado. Um atalho global de teclado, que você pode personalizar, chama o Mole de qualquer lugar, e Ocultar ícone do Dock o mantém só na barra de menus enquanto ele roda em segundo plano. Configure tudo em Ajustes › Barra de menus.

Alertas de privacidade por app. Quando um alerta nomeia um app, passe o cursor sobre a notificação do macOS e escolha Não notificar mais sobre este app. Restaure depois em Ajustes › Barra de menus › Notificações › Apps com alertas desativados. Um alerta só de câmera continua genérico, porque o macOS não expõe o app dono, então o Mole não oferece uma ação por app nesse alerta.

O conteúdo da barra de menus escolhe Ícone (o corredor), Dados em tempo real com até três indicadores configuráveis, ou Ícone e dados. Dois indicadores aparecem por padrão, e Terceiro dado de status acrescenta mais um. Cada indicador mostra um entre Uso da CPU, Memória em uso, Pressão de memória, Memória de troca, Uso da GPU, Espaço em disco usado, Temperatura do chip, Nível da bateria, Consumo de energia, Velocidade da ventoinha ou Bateria dos acessórios, e dois não podem levar o mesmo indicador. Mostrar velocidade da rede é um interruptor à parte, que acrescenta envio e recebimento ao lado desses indicadores. A escolha do corredor é só visual e nunca muda quais indicadores são amostrados. A disposição dos dados coloca os indicadores em Colunas (o padrão) ou Empilhado numa faixa compacta de duas linhas, e Inverter direção vira o corredor da esquerda para a direita.

A animação de um corredor pode ser pausada sem escolher outro personagem. O menu nativo Ferramentas expõe Manter tela ligada, Limpar tela, o controle de ventoinha em Macs compatíveis e WiFi de baixa latência. Atalhos opcionais abrem a janela principal ou ligam e desligam o resfriamento das ventoinhas. WiFi de baixa latência também aparece nos cartões de Rede; ele pausa temporariamente AWDL e AirDrop, e restaura o estado anterior ao desligar, ao dormir, ao sair ou numa mudança de rede. Ele não promete downloads mais rápidos.

Diagnóstico

No app, clique no logo do Mole no canto superior esquerdo da janela e escolha Executar diagnóstico. O Mole reúne um relatório curto de diagnóstico, só de leitura, cobrindo o modelo do Mac, a versão do macOS, as permissões, as operações recentes, a tela, os volumes externos, a rede, o estado de segurança e o ambiente. Clique em Copiar relatório e cole na mensagem para o suporte.

O diagnóstico confere sete condições: Acesso Total ao Disco ausente, pressão da memória alta, disco quase cheio, saúde da bateria baixa, reinício recomendado, um registro de operações que não pode ser gravado e falhas em operações recentes. Cada condição leva a um artigo de ajuda com os passos de resolução. Veja a página de Ajuda para o detalhe de cada uma.

Ajustes

Ajustes tem três abas. Geral contém o Idioma da interface (vale depois de reabrir), preferências de Limpeza, Itens que não serão limpos, ativação da licença e gerenciamento de aparelhos, Receber versões beta e um atalho de Acesso Total ao Disco. Limpeza inclui Exclusão de caches (Excluir permanentemente, o padrão, ou Mover para o Lixo), a entrada de IA, Remover também dados e ajustes e Desinstalação rápida. Ferramentas contém Manter tela ligada, Limpar tela, os atalhos deles e a Proteção de entrada do Limpar tela (que precisa da permissão de Acessibilidade do macOS), além da Proteção de carga da bateria e dos controles de ventoinha em Macs compatíveis. A Proteção de carga da bateria mantém a bateria interna entre 75% e 80% enquanto o Mole está em execução, com uma autorização de administrador; Encerrar aceleração após resfriar decide se Resfriar e Máx devolvem o controle ao macOS quando o Mac esfriou. Barra de menus contém Abrir Mole ao iniciar o Mac, Ocultar ícone do Dock, a aparência do ícone e do corredor, os indicadores visíveis e a velocidade da rede, o atalho Abrir Mole e as notificações, inclusive Alertas de câmera e microfone. A ativação da licença também se alcança com Cmd + Shift + L.

Opções do Terminal

Algumas opções de que só algumas pessoas precisam ficam fora dos Ajustes. Execute o comando no Terminal, depois saia e reabra o Mole. Para mostrar temperaturas em Fahrenheit, execute defaults write com.tw93.MoleApp temperatureUnitPreference -string fahrenheit; para voltar a Celsius, execute defaults delete com.tw93.MoleApp temperatureUnitPreference. Só os números exibidos mudam; as curvas das ventoinhas e os avisos continuam a partir das mesmas leituras.

CLI

Instalação

Instale com o Homebrew: brew install mole. Execute mo para o menu interativo, ou qualquer subcomando direto.

Comandos compartilhados (também no app para Mac)

mo clean

Limpeza funda de caches e arquivos temporários. Aceita --dry-run para pré-visualizar sem apagar, --debug para registros detalhados e --whitelist para gerenciar caches protegidos. Pula automaticamente os caches de apps em execução.

mo uninstall

Seleção interativa de apps com detecção de resíduos. Mostra o tamanho do app, o bundle ID e a data do último uso. Encontra as mesmas mais de quinze categorias de restos que o app para Mac. Aceita --dry-run.

mo optimize

Executa as tarefas de manutenção da CLI, com pedidos de administrador quando necessário. O conjunto exato de tarefas pode diferir da lista padrão de Otimizar no app para Mac. Use --whitelist para excluir tarefas específicas das próximas execuções.

mo analyze

Mapa de blocos interativo no terminal. Navegue com as setas ou com os atalhos do Vim (h/j/k/l). Mande arquivos para o Lixo direto do mapa. Aceita saída --json e caminhos personalizados, como mo analyze /Volumes para discos externos.

mo status

Painel do sistema ao vivo: CPU, GPU, memória, E/S de disco, rede, bateria, temperatura, tempo ligado, pontuação de saúde e os principais processos, com sparklines de 60 segundos. Aceita --json para encaminhar a outras ferramentas.

Comandos exclusivos da CLI

mo purge

Encontra artefatos antigos de compilação em diretórios de projeto: node_modules, target, .build, build, dist, venv. Varre caminhos configuráveis (padrão: ~/Projects, ~/GitHub, ~/dev). Projetos com menos de 7 dias são marcados como "Recent" e ficam desmarcados por padrão. Aceita --dry-run e --paths para configurar os diretórios da varredura.

mo installer

Descobre arquivos de instalador .dmg, .pkg e .zip em Downloads, Desktop, no cache do Homebrew, no iCloud e em anexos do Mail. Rotula cada arquivo pelo local de origem. Aceita --dry-run.

mo touchid

Ativa o Touch ID para comandos sudo. Execute mo touchid enable para configurar e mo touchid disable para reverter. Aceita --dry-run.

Comandos utilitários

mo completion

Configura o completamento por tab do shell para Bash e Zsh. Detecta o shell e atualiza o arquivo de configuração correspondente.

mo update

Atualiza a si mesmo para a última versão estável. Use --nightly para a build mais recente ainda não lançada, a partir de main (só instalações por script). Use --force para reinstalar a versão atual.

mo remove

Desinstala a CLI do Mole do sistema, inclusive arquivos de configuração e a integração com o shell. Aceita --dry-run.

Segurança

A CLI e o app para Mac compartilham os mesmos princípios de segurança:

Proteção de caminhos. Uma lista de negação embutida cobre diretórios críticos do sistema, a estrutura essencial da sua pasta pessoal e qualquer coisa fora de locais de cache conhecidos. Symlinks são resolvidos e validados antes de qualquer operação.

Consciência de processos. Caches de apps em execução são pulados durante a limpeza. Caches de navegador não são tocados enquanto o navegador está aberto.

Teste grátis e ativação. No app para Mac, cada ferramenta paga (Limpar, Apps, Otimizar e mover itens para o Lixo em Analisar) funciona duas vezes de graça. Depois disso, é preciso uma licença ativa. A varredura é sempre gratuita.

Lista de proteção. Tanto a CLI (~/.config/mole/whitelist) quanto o app para Mac deixam você proteger caches específicos ou tarefas de otimização das próximas execuções.

Registro de operações. Cada exclusão é registrada em ~/Library/Logs/mole/operations.log. A sobreposição de diagnóstico do app para Mac confere a saúde desse registro e mostra falhas recentes.

Pré-visualizar primeiro. A CLI aceita --dry-run em todo comando destrutivo. No app para Mac, Limpar e Desinstalar mostram a lista completa de arquivos e a contagem em bytes antes de qualquer remoção, e Analisar move itens avulsos para o Lixo, de onde podem ser colocados de volta.

Solução de problemas

O app para Mac inclui um diagnóstico embutido que detecta problemas comuns. Abra clicando no logo do Mole no canto superior esquerdo da janela e escolhendo Executar diagnóstico. Para condições específicas, veja a página de Ajuda.

Na CLI, acrescente --debug a qualquer comando para registros detalhados. Revise o registro de operações em ~/Library/Logs/mole/operations.log para a atividade recente. Se um comando falhar em silêncio, confira se o Acesso Total ao Disco está concedido nos Ajustes do Sistema.

Para relatar problemas, veja a seção Relatar um problema na página de Ajuda.