Como a limpeza de ferramentas de IA entrou no Mole

Nas férias eu queria acrescentar algo útil ao Mole: um jeito de limpar caches de IA, sessões antigas e worktrees de que você não precisa mais, e desinstalar ferramentas de IA que você experimentou há tempos e parou de usar.

Enquanto eu testava resíduos de desinstalação de centenas de apps de Mac, muita gente também perguntava sobre lixo de IA. Na época eu via boa parte desse "lixo" como útil. Suas conversas de programação com IA, por exemplo, são um ativo importante, então o Mole tratava sobretudo caches de verdade e versões antigas.

Conforme continuei usando IA, porém, o meu próprio Mac acumulou muitos arquivos gerados, sessões e worktrees que já não eram muito úteis. Isso deixou a necessidade mais clara, e comecei a trabalhar nisso. Um usuário também tinha um arquivo opencode.db que tinha crescido até 62 GB e perguntou como limpar. Desta vez instalei ferramentas de desktop e de linha de comando, entrei nas contas e usei antes de conferir o que elas deixavam para trás.

Como eu as testei

Ao contrário da última vez, quando os apps só eram instalados e removidos, desta vez entrei nas ferramentas que eu conseguia usar e experimentei nos meus próprios projetos: fazendo perguntas, rodando agentes, construindo um índice de código, configurando uma tarefa agendada. Muitos dados só aparecem depois do uso real, então um app instalado e nunca aberto esconde a maior parte. Para cada ferramenta, a IA comparou o Mac antes e depois, mediu o que ela gravou na pasta pessoal, em ~/Library, em /usr/local/bin e na configuração do shell, e registrou num livro. Depois olhei quantos processos e quanta memória ela ocupava na página Status do Mole, desinstalei com o Mole e busquei na pasta pessoal inteira pelo nome qualquer coisa que o Mole não tivesse listado. O que faltava entrou no código na mesma noite, seguido de um novo teste.

No lado do desktop testei 13 apps: Devin, OpenCode, Trae, Trae CN, TRAE SOLO CN, Kiro, Qoder, QoderWork, Qoder CN, Lingma, CodeBuddy CN, WorkBuddy e Doubao Work. Doze foram de fato usados; o Lingma não tinha cota depois do login, então só medi os arquivos que ele gravou. Na linha de comando instalei e rodei Amp, opencode, Kimi CLI, Kimi Code, Factory Droid, Copilot CLI, Gemini CLI, Qwen Code e iFlow e, junto com Claude Code, Codex, Grok e Cursor Agent, que já estavam no meu Mac, são 13. Seguindo a lista que o CC Switch suporta, também medi o que OpenClaw, Hermes e Pi deixam depois da remoção. O Amp se destacou como bem feito, com um caráter forte próprio. O Qoder CN foi provavelmente o melhor produto chinês de IA que testei naquele dia, simples e claro no conjunto. Alguns não puderam ser usados: não consegui entrar no Gemini CLI com a minha conta pessoal do Google durante este teste, e Qwen Code e iFlow precisam de um endpoint e de uma chave seus.

Você só vê o que elas gravam quando usa

A memória foi a parte mais visível. Com os 13 apps de desktop abertos juntos eles usavam cerca de 23 GB, e o CodeBuddy CN sozinho rodava 41 processos usando 4,49 GB. A maioria é app de VS Code ou Electron, em que uma janela esconde uma cadeia de auxiliares, e é por isso que a página Status do Mole dá a cada app uma única linha que soma todos os processos filhos. Olhando uma lista simples de processos, é difícil dizer quem está de fato usando a memória.

As mudanças pequenas que elas fazem no sistema foram mais surpreendentes. Devin, CodeBuddy, Kiro e Kimi Code acrescentam linhas de PATH ou de integração do shell a ~/.zshrc, e na primeira abertura Kiro, Trae e Trae CN põem um link de comando de propriedade do root em /usr/local/bin, que aponta para nada quando o app some. O WorkBuddy pôs um python3.12 em ~/.local/bin, então digitar python3.12 no Terminal depois roda a cópia dele, e ele também instalou um Python uv de 127 MB; as minhas palavras na hora foram que era mais intrusivo do que eu esperava. O mais interessante foi o Kimi CLI: rodei uma vez, ele me disse que não era mais mantido e então, sem perguntar, baixou e instalou o novo Kimi Code, editou .zshrc e renomeou o comando antigo para kimi-legacy.

Em tamanho, o primeiro uso do modo Work do TRAE SOLO baixa cerca de 1 GB de ferramentas que descompactam para 3,1 GB, um conjunto empacotado de LibreOffice, FFmpeg e OpenJDK, e seis ferramentas de desktop que rodaram só uma ou duas tarefas gravaram 5,2 GB de dados entre elas. O meu próprio ~/.codex, que uso todo dia, já está em 24 GB, 17 GB disso em sessões, e 12 GB dos 14 GB do app de desktop do Claude são a máquina virtual Linux que o Cowork usa. O banco do opencode registra eventos, então uma pergunta grava mais de três vezes o tamanho da própria mensagem, e apagar uma sessão não encolhe o arquivo, que é provavelmente como alguém chegou a 62 GB.

Skills foram outra armadilha. Muitos instaladores de skill gravam uma pasta skills/ no diretório de cada agente, tenha você aquele agente ou não, então ~/.qwen, ~/.iflow e ~/.factory existiam no meu Mac embora eu nunca tivesse usado Qwen Code, iFlow ou Droid. A primeira versão do Mole até os contou como ferramentas de 2,4 MB e chegou perto de tratar as skills instaladas como resíduos.

Algumas coisas ficam depois da desinstalação

Depois que a primeira rodada removeu 14 apps, uma busca nova ainda achou mais de uma dúzia de pastas com ponto que o Mole não tinha listado, como ~/.kiro, ~/.qoder, ~/.qodersec, ~/.lingma e ~/.codebuddy, mais o arquivo de token de login que o Kiro guarda em ~/.aws. Elas não ficam em ~/Library, e os nomes nem sempre batem com o app, então o único jeito de achá-las foi um app de cada vez. Algumas são compartilhadas entre produtos: Trae CN e TRAE SOLO CN compartilham ~/.trae-cn, Qoder e QoderWork compartilham ~/.qoder, então remover um deles não pode listar uma pasta que o outro ainda usa. Testar o Trae internacional também mostrou que ele reivindicava as pastas do Trae CN como suas, com os caches marcados por padrão; depois da correção a lista foi de 33 linhas para 14.

Processos foram a outra surpresa. Conferindo de novo na manhã seguinte, ~/.kimi-code e ~/.factory tinham voltado depois de apagados, porque as sessões kimi e droid que eu tinha deixado abertas no Terminal na noite anterior ainda estavam vivas: os arquivos do programa já estavam no Lixo, e os processos continuavam gravando logs naquelas pastas. Depois achei sessões gemini, qwen, iflow e amp ainda rodando também. Ferramentas de linha de comando não têm janela, e fechar uma aba do Terminal nem sempre as encerra, então vale conferir que uma não está rodando antes de desinstalar.

Os testes também me lembraram por que uso Claude, Codex e Cursor com tanta frequência: eles têm sido bastante contidos. Algumas outras ferramentas me deixaram desconfortável. Vi instaladores gravarem na área de transferência para rastrear o canal de instalação, o que pareceu ir longe demais, e apps que me recebiam com pop-ups pedindo para entrar em promoções por tokens. Usá-las às vezes significava aguentar muita irritação.

O Qoder foi uma surpresa agradável. Mostrou contenção e bom gosto, e o produto me impressionou. Espero ver mais software chinês assim. Continuem.

Você pode olhar primeiro por conta própria

Nenhuma dessas verificações precisa do Mole; o Terminal basta, e os comandos abaixo só leem, não mudam nada.

Primeiro, veja se ferramentas de IA acrescentaram linhas à configuração do shell:

grep -nE "codeium|codebuddy|kiro|kimi|lmstudio|\.local/bin" ~/.zshrc ~/.bashrc ~/.zprofile 2>/dev/null

Cada linha começa com o nome do arquivo e o número da linha. Se a ferramenta por trás de uma linha já se foi, você pode apagar a linha num editor de texto; copie o arquivo primeiro e abra uma janela nova do Terminal depois para conferir que tudo ainda funciona.

Em seguida, procure comandos em /usr/local/bin que apontam para dentro de um app, e links que não funcionam mais:

ls -l /usr/local/bin | grep "\.app/"
find /usr/local/bin -maxdepth 1 -type l ! -exec test -e {} \; -print

O primeiro lista comandos que apontam para dentro de um app, o segundo lista links cujo alvo sumiu. A maioria desses foi deixada por apps removidos; pertencem ao root, então apagá-los pede a senha de administrador.

Veja se um agente de linha de comando que você já removeu ainda está rodando:

ps -axo pid,lstart,command | grep -E "kimi|droid|gemini|qwen|iflow|amp|opencode" | grep -v grep

Esta é uma busca de texto pelo nome. Inspecione o comando completo e o ID do processo para confirmar que cada correspondência pertence à ferramenta de IA; amp também pode ocorrer dentro de palavras sem relação. Depois de confirmar, encerre no Terminal original, ou use kill com aquele ID de processo se não achar a janela.

Por fim, meça quanto essas ferramentas ocupam:

du -sh ~/.codex ~/.claude ~/.grok ~/.gemini ~/.cursor ~/.local/share/opencode 2>/dev/null

Essas pastas guardam o histórico das suas sessões, então decida se vai querer olhar de novo antes de apagar qualquer coisa: uma conversa de IA apagada sem uma cópia retida não pode ser recuperada.

Descobrir o que uma pasta grande contém

A pasta de uma ferramenta de IA pode conter caches que se reconstroem, modelos baixados, conversas, projetos e configuração compartilhada com outra ferramenta. Um nome que parece cache não torna todo arquivo descartável. Para limpeza manual, inspecione primeiro os dados que se reconstroem e depois confira títulos, datas e backups do seu próprio trabalho. Para um worktree, confira tanto alterações não commitadas quanto se os commits estão preservados num branch que você pretende guardar.

Um opencode.db inalterado depois de apagar sessões não significa necessariamente que a exclusão falhou. A documentação do SQLite diz que registros apagados em geral deixam páginas disponíveis para reúso sem encolher o arquivo. A compactação recupera essas páginas vazias; não apaga outra rodada de conversas. Decida quais sessões remover antes de manter o banco, em vez de juntar as duas coisas numa única ação grande de exclusão.

Como o Mole trata isso agora

A página de IA chegou com o Mole 1.16.0. A entrada é uma Lua distante na página Limpar, que só aparece quando dados de ferramentas de IA são encontrados e pode ser ocultada nos Ajustes se você não a quiser. Lá dentro, o Mole passa pelas ferramentas uma a uma e separa o que encontra em três faixas, pelo quanto você poderia se arrepender de remover: caches e versões antigas se reconstroem e começam marcados; sessões e worktrees não se reconstroem, então você confirma; ferramentas sem uso há tempos e manutenção vêm por último e também não vêm marcadas.

Na faixa de sessões, sessões antigas do Codex e do Claude Code além do período de retenção podem ser filtradas em 15, 30, 90 ou 120 dias, ou definidas como Não listar, separadamente para cada ferramenta, e, uma vez expandidas, cada uma mostra título e data e pode ser desmarcada sozinha. Para o Codex, o Mole primeiro copia o arquivo da sessão para o Lixo e depois chama o comando de exclusão do próprio Codex, para o índice do Codex continuar consistente. Sessões do Claude Code cuja pasta de projeto sumiu ganham uma linha própria, e um worktree concluído só aparece quando o git pode provar que não há alterações não commitadas, com uma nota quando o trabalho já foi mesclado no branch principal.

A faixa de ferramentas sem uso levou mais tempo nesta rodada. O Mole procura ferramentas de linha de comando de IA nos lugares fixos que npm, pipx, uv, instaladores oficiais e Homebrew usam, lista só as sem uso por 30 dias e que não estão rodando, e remove o programa, os links de comando que apontam para ele, e os ajustes, as sessões e o login juntos. Dados que outro produto ainda usa ficam: o Antigravity também guarda coisas em ~/.gemini, e o app de desktop do opencode compartilha um banco de sessões com a linha de comando. Cada ferramenta sem uso ganha a própria linha e a própria caixa de seleção; ferramentas nunca são dobradas numa remoção só. Claude Code e Codex não estão na lista, porque as pastas deles também são o estado dos apps de desktop.

Ferramentas de linha de comando instaladas em pastas do sistema com sudo npm também são listadas, e removê-las pede a senha de administrador uma vez. Para o opencode.db que não para de crescer, quando sessões apagadas deixaram mais de um décimo do arquivo vazio e o arquivo passa de 200 MB, o Mole oferece compactá-lo nesta faixa: nenhuma sessão é removida, só o espaço livre volta ao disco, e o opencode tem de ser encerrado primeiro.

No lado da desinstalação, as pastas com ponto acima agora são listadas como linhas para confirmar, desmarcadas por padrão, e uma pasta que vários produtos compartilham não é listada enquanto outro deles ainda está instalado. Links de comando de propriedade do root em /usr/local/bin também são listados durante a desinstalação e vão para o Lixo pelo auxiliar de administrador do Mole. Arquivos comuns movidos para o Lixo podem ser recuperados enquanto continuam lá. Programas instalados pelo Homebrew ainda usam o comando de desinstalação do Homebrew. Sessões de banco precisam do arquivo de recuperação exportado e das instruções de restauração; nem toda operação pode ser revertida arrastando algo para fora do Lixo, e a cópia de recuperação ainda precisa existir. Linhas de arquivo de configuração que o instalador de uma ferramenta de IA deixou são listadas no resultado da desinstalação, em vez de editadas.

Essas mudanças já estão no Mole.

O que ainda não está feito

Algumas coisas ainda não estão feitas. Worktrees de ferramentas como Cursor e Conductor não estão incluídos porque ainda não tenho dados reais deles no meu Mac. Na época daquele teste, sessões antigas do opencode e do Devin não podiam ser limpas por idade no Mole. Não testei o MiniMax nesta rodada, então ele ainda não é suportado.

Continuação: sessões do OpenCode e do Devin

No dia 1º de outubro acrescentei suporte na origem para sessões antigas do OpenCode e do Devin, usando o filtro de retenção ou conferindo que as pastas de trabalho estão comprovadamente ausentes. Discos offline e pastas ilegíveis não contam como ausentes. O Mole salva uma cópia de recuperação antes da exclusão, depois usa a rota de exclusão da ferramenta e verifica o resultado. A recuperação do OpenCode usa o JSON exportado; a recuperação do Devin contém a sessão selecionada e os registros relacionados, com instruções de restauração. Uma ferramenta em execução ou uma verificação que falha impede a limpeza. Era trabalho para a Preview seguinte, não um recurso no download publicado na época; não medi o espaço recuperado no banco real do usuário.

No dia 5 de outubro veio outra rodada. Você não precisa mais encerrar o Codex ou o Claude Code antes de limpar: uma sessão usada nas últimas 24 horas nunca é listada, e o comando de exclusão do próprio Codex recusa uma sessão aberta numa das janelas dele, o que foi verificado numa sandbox. A retenção é definida por ferramenta e toda ferramenta começa em Não listar, então nenhuma sessão é listada até você escolher uma janela; o Claude Code lista sessões antigas pela hora da última mensagem, e não só aquelas cujo projeto sumiu. Também achei que o app de desktop do Cursor instala a própria cópia do cursor-agent e guarda cada versão que substitui, sete delas e 4,1 GB no meu Mac, e essas agora aparecem com as outras versões antigas e podem ir enquanto o Cursor está aberto. A exclusão do Codex deixa para trás as imagens e notas que renderizou para uma sessão, então o Mole as move para o Lixo junto com a sessão.

Junto com os testes anteriores de mais de 700 apps, isso me deixou desapontado com quantos produtos ficam aquém de princípios básicos de engenharia de software. Nem sempre são tão profissionais ou limpos quanto as pessoas esperam. Isso me faz querer que o Mole mantenha a simplicidade, aprofunde o que faz, evite pegar dados de que não precisa e nunca envie arquivos locais ou conteúdo de conversa. Eu nem acrescento análise de uso. Quero continuar sendo assim de exigente por muito tempo.

Se há ferramentas de IA no seu Mac das quais você gostaria que o Mole cuidasse, ou um tipo de limpeza que mais incomoda, me diga na thread de discussão. Cada app testado até agora está na lista de apps testados, e, se você quiser limpar à mão, o guia de limpeza de ferramentas de programação com IA cobre isso.

Vou incluir pedidos nos testes e acrescentar o que se provar adequado para limpeza. É algo que espero continuar mantendo por muito tempo.