Como o Wipecraft funciona

No uso diário

Seu trabalho fica onde está

As linhas que guardam trabalho em andamento ficam bloqueadas. Você as vê, mas não pode selecioná-las.

Enquanto o Claude Code ou o Codex está em execução: as sessões que ele tem abertas, tudo o que ele alterou nas últimas 24 horas e o worktree em que ele trabalha.
Os caches do Cursor enquanto o Cursor está aberto.
Um worktree com alterações sem commit, um que mudou nos últimos 7 dias ou um cujos commits não estão na branch principal nem em um remoto.
Um simulador em execução.
A imagem ativa do sandbox do Claude Desktop.

Nada vem selecionado. “Selecionar recomendados” escolhe só itens de “Seguro para remover” e “Volta”, e nunca um item de “Você decide”.

A análise só lê. Um teste compara cada arquivo de uma pasta pessoal de teste antes e depois de uma análise completa, e de novo depois da análise e do status pela linha de comando.

7 dias para mudar de ideia

Os arquivos que nenhum app recria vão para a Quarentena no mesmo disco quando você os remove. Cada linha mostra quantos dias faltam e um botão Restaurar. Depois de 7 dias, a Quarentena se esvazia na próxima vez que o Wipecraft for aberto ou fizer a verificação diária. Se você precisa do espaço hoje, “Esvaziar Agora” o libera após uma segunda confirmação.

Três tipos de ação não passam pela Quarentena.

Caches, logs e arquivos temporários que o app deles recria sozinho são removidos diretamente. Não podem ser restaurados, e a linha ou o cartão diz isso antes de você confirmar. O Wipecraft só faz isso com pastas e arquivos que ele sabe que um app recria. Se não houver um app conhecido que recrie o item, ele vai para a Quarentena.
Os worktrees são removidos com o git; a branch deles continua no repositório.
Alguns comandos de ferramentas são marcados como “Irreversível”, e o Wipecraft os nomeia e pede uma segunda confirmação.

Alguns caches ficam na Quarentena porque a ferramenta deles não os recupera sozinha: os caches do JetBrains e do Android Studio (que também guardam o histórico local da IDE), os módulos do Maven e do Go, e os dados de ferramentas em Library/Caches, como os ambientes do Poetry, os navegadores do Playwright e do Cypress e os modelos do llama.cpp.

Os históricos de sessões não são excluídos. Eles vão para um arquivo compactado que você pode restaurar.

Avisa quando algo cresce

O monitoramento fica desativado até você ativá-lo. Quando ativado, um ícone na barra de menus indica isso, e o Wipecraft verifica uma vez por dia, no horário que você escolher. Ele avisa quando:

um item cresce 2 GB ou mais em 7 dias,
menos de 10% do disco está livre,
um worktree ou simulador de 1 GB ou mais ficou 7 dias sem ser usado,
seu último backup do Time Machine tem mais de 7 dias.

Encerre o app e tudo para.

Regras que você define, e filtros

As regras de limpeza são opcionais. Não existe nenhuma até você adicionar uma em Ajustes > Limpeza automática.

Uma regra define as fontes, quantos dias um item deve ficar sem uso (de 7 a 365) e um tamanho mínimo.
Depois da verificação diária, os itens que atendem a uma regra vão para a Quarentena ou são arquivados, e uma notificação diz quantos.
As regras ignoram linhas bloqueadas. Elas nunca executam um comando, nunca removem um worktree e nunca fazem nada que não possa ser desfeito. Os caches removidos diretamente não fazem parte da limpeza agendada; as regras só pegam itens que vão para a Quarentena ou para o arquivo.
As regras só funcionam com o monitoramento ativado.
Sem licença, uma regra não move nada. Se uma regra tivesse algo para mover, o Wipecraft avisa uma vez por dia que a limpeza não foi executada.

Toda lista de resultados pode ser filtrada pelo tempo que um item ficou sem uso, por fonte e por nível de segurança. Um filtro oculta linhas e as tira da seleção.

Nunca mexe em trabalho sem push

Um worktree cujo repositório git ainda existe só é oferecido para remoção quando os commits dele também existem em outro lugar. A única exceção é um worktree cujo repositório não existe mais; veja o último item.

Os commits dele precisam estar na branch principal ou em uma branch remota. Se não estiverem, a linha fica bloqueada com o motivo “Os commits dele ainda não estão na branch principal nem em um remoto.”
Commits feitos depois do último push mantêm o bloqueio.
Um squash merge coloca commits novos na branch principal, então os commits da própria branch nunca aparecem lá. Se o GitHub mostra que o pull request da branch recebeu merge, o Wipecraft retira esse único bloqueio. Ele pergunta pelo seu próprio login do gh, só quando o gh está instalado e conectado, e você pode desativar isso em Ajustes > Privacidade. Alterações sem commit continuam bloqueando o worktree.
O Wipecraft verifica de novo logo antes de remover um worktree. Se os commits não estiverem mais na branch principal nem em um remoto, ou se o pull request não aparecer mais com merge, ele não remove nada.
Um worktree cujo repositório principal foi movido ou excluído não pode ser verificado pelo git. O Wipecraft só o oferece depois de 30 dias sem alterações (o padrão) e move a pasta inteira para a Quarentena, de onde o botão Restaurar a traz de volta.

Guarda seu .env quando remove um worktree

git worktree remove exclui a pasta, inclusive os arquivos que o git ignora: .env, bancos de dados locais e ajustes do editor. O Wipecraft tira esses arquivos de lá antes.

Antes de remover um worktree, o Wipecraft move para a Quarentena, por 7 dias, os arquivos ignorados dele que não são saída de build. A saída de build, como node_modules e target, é excluída junto com o worktree.
A linha informa quantos arquivos vão para a Quarentena antes de você confirmar.
Se o git se recusar a remover o worktree, o Wipecraft devolve os arquivos para onde estavam.
O botão Restaurar recria as pastas em que esses arquivos estavam.
Esses arquivos nunca são oferecidos sozinhos. A saída de build é oferecida em uma linha separada, também para um worktree bloqueado.

Funciona no Terminal e dentro do Claude Code

Linha de comando. O Wipecraft inclui um comando wipecraft dentro do app. Ajustes > Geral > Ferramenta de linha de comando mostra a linha que o coloca no seu PATH.

wipecraft scan e wipecraft status listam o que pode ser liberado e, com --json, imprimem JSON com versão. Eles não alteram nada.
wipecraft clean mostra o que faria. Nada muda até você adicionar --apply.
Com --apply, wipecraft clean faz com cada item que você indicar o mesmo que o app: caches, logs e arquivos temporários que o app deles recria são removidos diretamente e não podem ser restaurados (o plano diz “Would remove directly”), os outros arquivos vão para a Quarentena, os históricos de sessões são arquivados, e um worktree concluído é removido com git worktree remove depois que os arquivos ignorados dele que não são saída de build vão para a Quarentena. O registro de exclusões anota cada ação. --all-safe escolhe só itens que vão para a Quarentena. Ele exige a mesma licença do app.
Ele recusa linhas bloqueadas e linhas que mudaram desde a análise. Ele não executa ações marcadas como “Irreversível”; ele pede que você abra o app.
wipecraft quarantine list mostra o que está na Quarentena, e wipecraft quarantine restore <id> devolve uma entrada. Nenhum dos dois exige licença.
Se o app ou outro terminal estiver movendo arquivos, o comando para com uma mensagem dizendo que o Wipecraft está ocupado e não move nada.
Ele imprime scripts de autocompletar para zsh, bash e fish.

Plugin do Claude Code. O plugin adiciona dois comandos e dois hooks de sessão.

/wipecraft:status resume wipecraft scan --json. /wipecraft:tidy mostra primeiro a simulação e só executa --apply depois que você diz sim no chat.
Quando uma sessão começa e mais de 1 GB pode ser liberado, ele adiciona uma linha à sessão. A linha vem de um resumo salvo na última atualização, então uma sessão nunca espera por uma análise. Sem um resumo das últimas 24 horas, ele não imprime nada e atualiza o resumo em segundo plano.
Quando uma sessão termina dentro de um worktree vinculado, ele imprime o estado desse worktree em uma linha.
Organizar um worktree concluído vem desativado por padrão. É uma opção em Ajustes > Agentes.
Com a opção ativada, wipecraft clean é executado em segundo plano, pouco depois do fim da sessão, só para o worktree dessa sessão. Ele passa pelas mesmas verificações do comando, e um worktree ainda bloqueado fica onde está.

Outros agentes (MCP). wipecraft mcp é um servidor que o Claude Code, o Codex, o Cursor e outros agentes podem iniciar no seu Mac. Ele se comunica apenas pela entrada e saída padrão; o código-fonte dele não usa conexão de rede e não escuta em nenhuma porta.

Um agente pode ler os totais, listar e explicar itens e ver o que está na Quarentena. Essas solicitações não alteram nada.
A limpeza por um agente fica desativada até você ativar “Permitir que agentes limpem via MCP” em Ajustes > Agentes.
Quando ativada, uma solicitação mostra o plano, a menos que o agente peça para aplicar. Aplicar exige licença e ignora linhas bloqueadas. Para cada id que o agente indicar, faz o mesmo que wipecraft clean --apply: caches, logs e arquivos temporários que o app deles recria são removidos diretamente e não podem ser restaurados, os outros arquivos vão para a Quarentena, os históricos de sessões são arquivados, e um worktree concluído é removido com o git. A descrição da ferramenta diz ao agente quais itens não podem ser restaurados, para que ele avise antes de aplicar. Ações marcadas como “Irreversível”, como remover um instantâneo local do Time Machine, continuam sendo recusadas.
Ajustes > Agentes lista o texto de configuração para o Claude Code, o Codex e o Cursor. O Wipecraft mostra o texto e não altera os ajustes de nenhum agente.

O que ele encontra

Cada linha diz o que é, qual o tamanho e o que acontece se você a remover. Quando algo pode voltar, ela também diz como.

Claude Code, Codex, worktrees e as ferramentas de desenvolvimento abaixo aparecem quando o Modo desenvolvedor está ativado. Veja as perguntas frequentes.

Agentes de IA e apps de IA

Claude Code. Históricos de sessões, agrupados por projeto e mês. Eles são arquivados, não excluídos. Também o histórico de arquivos, snapshots do shell, logs de depuração e plugins.
Codex. Sessões, sessões arquivadas e os bancos de dados de histórico de conversas e de logs. Tudo isso é arquivado, não excluído. Também imagens geradas e cache.
Claude Desktop. Pacotes de VM. A imagem ativa do sandbox é mostrada e fica bloqueada. As cópias compactadas dela e os dados restantes de inicialização rápida só são oferecidos enquanto o Claude Desktop está fechado. Caches também.
Cursor. Os caches dele.
Modelos locais. Ollama, LM Studio, o cache do Hugging Face, o cache do PyTorch e os modelos do Whisper, com tamanho e último uso.
Worktrees do git. De qualquer agente ou seus: os worktrees dos repositórios git da sua pasta pessoal e as pastas em .claude/worktrees. Cada um mostra a branch, o tamanho, a última alteração e, à parte, os arquivos que o git ignora. Os worktrees são agrupados pela ferramenta que os criou: Claude Code, Codex, Cursor ou Outros. O grupo vem da pasta ou do nome da branch.
Restos de worktrees. As pastas cujo repositório principal foi movido ou excluído aparecem na lista, assim como os registros do git de worktrees cujas pastas não existem mais. Remover os registros executa git worktree prune, que não exclui nenhum arquivo. Um registro cuja pasta foi movida, e não excluída, fica bloqueado, e a linha pede para executar git worktree repair.

Ferramentas de desenvolvimento

Xcode. Dados de build por projeto, archives, arquivos de suporte a dispositivos, pré-visualizações e o cache de módulos. Um projeto que o Xcode tem aberto fica bloqueado.
Simuladores. Cada dispositivo com o tamanho e o último uso. “Remover dispositivo” e “apagar conteúdo” são ações separadas. As imagens de runtime só são oferecidas quando nenhum simulador as usa.
Caches de pacotes. npm, pnpm, Yarn, pip, Homebrew, CocoaPods, Swift Package Manager, Gradle e Cargo, e também Bun, uv, conda, Go e Maven.
Saída de build. node_modules em projetos que não mudaram há 30 dias. Também pastas como .venv, target, .next, build, dist, Pods e .build, só quando o projeto tem o arquivo marcador (por exemplo Cargo.toml ou package.json), o git ignora a pasta e o projeto não mudou há 30 dias. Você pode alterar os 30 dias. Um agente de programação ou editor iniciado na pasta do projeto o bloqueia enquanto está em execução.
Editores. Caches e logs do VS Code, das IDEs da JetBrains e do Android Studio. Eles ficam bloqueados enquanto o editor está em execução. Uma pasta de uma versão antiga da IDE informa isso.
Android. Emuladores (dispositivos virtuais) e imagens de sistema do SDK. Um emulador vai para a Quarentena e fica bloqueado enquanto um emulador está em execução ou o arquivo de bloqueio dele existe. Uma imagem de sistema fica bloqueada enquanto um dispositivo a usa, e também quando o Wipecraft não consegue ler as configurações de um dispositivo.
Docker. Imagens e volumes, enquanto o Docker está em execução. Uma imagem ou um volume que um contêiner usa fica bloqueado. Também o cache de build que nenhum build usa no momento; removê-lo executa docker builder prune --all --force, que não pode ser desfeito. A pasta de dados do OrbStack é mostrada com o tamanho, e o Wipecraft não a remove.

Dados do Sistema

O painel Armazenamento nos Ajustes do Sistema mostra um único número para Dados do Sistema. O Wipecraft parte do espaço usado do disco e divide cada byte usado em quatro partes: macOS, Apps, Seus arquivos e Dados do Sistema. As partes somam o espaço usado.

Os Dados do Sistema são divididos de novo em cinco grupos. Cada um tem uma cor e uma explicação de uma frase.

Seu Mac precisa disto. O arquivo de troca, os bancos de dados do sistema e os dados que os apps guardam para si. Mostrado, nunca oferecido para remoção.
Seguro para remover. Caches, logs e arquivos temporários que o app deles recria sozinho.
Volta. Pode ser removido, mas se enche de novo com o uso, como os caches de navegadores e de pacotes.
Você decide. A única cópia de algo que não volta sozinho, como modelos locais, emuladores, simuladores, worktrees, imagens do Docker e históricos de sessões. O cartão diz o que é cada um e quando você o usou pela última vez. Eles vão para a Quarentena, onde você pode restaurá-los por 7 dias, ou para o arquivo, que você pode restaurar.
O macOS não mostra. O que sobra depois de tirar tudo o que o Wipecraft consegue identificar, com um motivo: o Acesso Total ao Disco está desativado, pastas que só um administrador consegue ler, ou a sobrecarga do APFS e os clones.

O ícone de lixeira de um cartão remove só o que é seguro: os itens de “Seguro para remover” e “Volta” que não estão bloqueados. Ele nunca pega um item de “Você decide”, e um item que um app mantém aberto continua bloqueado. O cartão vira primeiro e diz o que vai acontecer e se dá para desfazer.

Os instantâneos locais do Time Machine são listados um a um, com as datas, fora dos grupos. O macOS não informa o tamanho de um instantâneo local, então o Wipecraft não estima um. Remover um instantâneo é marcado como “Irreversível” e pede sua senha de administrador a cada vez.

Algumas dessas pastas exigem Acesso Total ao Disco. Sem ele, suas pastas de usuário continuam sendo analisadas, e a Visão Geral informa quais pastas não puderam ser contadas.

Como desfazer funciona

Tipo de linha	O que o Wipecraft faz	Como recuperar
Recriado automaticamente	Remove diretamente, sem passar pela Quarentena. Só para caches, logs e arquivos temporários que o app deles recria. A linha ou o cartão diz isso antes de você confirmar.	Não há o que restaurar. O app o recria quando precisar. Não pode ser desfeito.
Recuperável	Move os arquivos para a Quarentena.	Restaurar, em até 7 dias. Ou baixar ou gerar de novo.
Históricos de sessões (marcados como “Recuperável”)	Compacta tudo em um arquivo compactado e depois remove os originais.	Restaurar dos Arquivados. Os arquivos compactados ficam até você restaurá-los.
Worktree (marcado como “Recuperável”)	Move para a Quarentena os arquivos ignorados que não são saída de build (como `.env`) e depois executa `git worktree remove`. A pasta é excluída diretamente, sem Quarentena, junto com a saída de build.	A branch continua no repositório. Execute `git worktree add` com a branch para fazer o checkout de novo. Restaurar traz de volta os arquivos guardados.
Irreversível	Executa o comando da própria ferramenta. Ele nomeia o comando antes e pede uma segunda confirmação.	A confirmação diz como obter de novo.
Bloqueado	Nada.	Nada a recuperar.

Os caches que a ferramenta deles não recupera sozinha não ficam na primeira linha. Eles vão para a Quarentena: os caches do JetBrains e do Android Studio, os módulos do Maven e do Go, e os dados de ferramentas em Library/Caches, como os ambientes do Poetry, os navegadores do Playwright e do Cypress e os modelos do llama.cpp.

As ações irreversíveis são: remover um instantâneo local do Time Machine, excluir um runtime de simulador, apagar o conteúdo de um simulador, remover uma imagem ou um volume do Docker e remover o cache de build do Docker.

O Wipecraft só oferece para remoção um worktree cujo repositório existe quando ele está limpo: nenhum arquivo rastreado alterado, nenhum arquivo não rastreado que o git não ignore, nenhuma alteração há 7 dias (o padrão; você pode mudar em Ajustes) e os commits dele na branch principal ou em um remoto. Um worktree cujo repositório principal não existe mais não pode ser verificado pelo git. Ele é oferecido depois de 30 dias sem alterações (o padrão) e vai para a Quarentena como uma pasta inteira. Os arquivos dele que o git ignora (saída de build, dependências) também formam uma linha separada, que vai para a Quarentena. Essa linha pode ser oferecida mesmo quando o próprio worktree está bloqueado, por exemplo por alterações sem commit.

A Quarentena move arquivos dentro do mesmo disco, então o espaço volta quando ela se esvazia. A tela Quarentena mostra os dois números: “Na quarentena” e “Libera se esvaziar agora”.

Cada ação é gravada em um registro de exclusões local: quando, o quê, quanto e que tipo de ação. Você pode exportá-lo como CSV nos Ajustes.

Privacidade em 10 princípios

Sem conta.
Sem telemetria e sem coleta de dados de uso no app.
O Wipecraft não envia nenhum nome de arquivo nem caminho para lugar nenhum. Um agente de programação que você mesmo conecta recebe os resultados da análise no seu Mac, por uma conexão local. O que esse agente faz com eles é assunto do provedor dele.
A análise lê tamanhos, datas e o estado das ferramentas (git, simctl, Docker) neste Mac. Ela não envia nada.
O app faz chamadas de rede para duas coisas: sua licença, se você ativar uma (com o nome do seu Mac como rótulo da ativação), e a busca de atualizações. Uma verificação opcional passa pelo seu próprio login do gh, só quando o gh está instalado e conectado. Você pode desativá-la nos Ajustes, e então o gh nunca é executado.
Os relatórios de falhas vêm desativados por padrão. Se você os ativar, eles só são enviados quando o app falha, sem nomes de arquivos nem caminhos (Sentry, região da UE).
Nada é executado em segundo plano a menos que você ative o monitoramento, e o ícone dele na barra de menus mostra que está ativado. O único outro caso é o plugin do Claude Code, se você o instalar: os hooks dele executam wipecraft quando uma sessão começa ou termina.
Nenhum auxiliar de administrador é instalado. A senha de administrador só é pedida para remover um instantâneo, a cada vez. O comando wipecraft é executado com as suas próprias permissões e não executa comandos de administrador.
O registro de exclusões fica no seu Mac. Você mesmo o exporta.
Sua chave de licença fica guardada nas suas Chaves. O comando wipecraft a lê de lá para verificar a licença.

Todos os detalhes: wipecraft.app/privacy/pt-BR