Use a skill
Entregue ao Claude Code, Cursor, OpenCode ou a outro agente com acesso ao shell. Ela lê apenas cabeçalhos, mostra o plano primeiro e entrega o comando de desfazer.
Abrir a skillOu e cole no Claude Code, Cursor ou OpenCode.
Código aberto · Skill para agentes · App local
Limpe sua caixa de entrada.
Desfaça cada movimento.
CleanYourMail é uma skill de agente open source para limpeza IMAP, com um app local opcional. Ela lê apenas cabeçalhos, mostra um plano antes de qualquer alteração, protege os e-mails importantes e entrega o comando de desfazer. O descadastro é separado e irreversível.
Grátis · MIT · Sem conta · Sem telemetria · Sem exclusão permanente
SKILL PARA AGENTESProduto principal
Entregue ao seu agente.
Leia o SKILL.md de
https://github.com/jparedesDS/cleanyourmail
e siga as instruções exatamente.
Use python tools/mail.py.
Só cabeçalhos. Nunca exclua permanentemente.
Mostre o plano antes de mudar qualquer coisa.
Mova primeiro, verifique e depois cancele a inscrição separadamente.
Me dê o comando de desfazer.Cole no Claude Code, Cursor, OpenCode ou em qualquer agente com acesso ao shell.
Skill primeiro · app opcional · CLI no GitHub
Escolha seu caminho
Use a skill ou o app.
A skill é o produto principal: entregue ao seu agente de código e revise o plano. O app é o caminho simples para quem prefere botões. A CLI continua no GitHub para usuários avançados.
App · MVP inicial
Baixe o app
Um app local e seguro para quem prefere botões a prompts. Escaneie cabeçalhos, revise o plano, aplique movimentos reversíveis e desfaça tudo em uma só tela. Sem conta, sem telemetria; o feedback é opcional.
Baixar para WindowsWindows 10/11 · instalador · MVP inicial
Prefere o terminal? A CLI continua no GitHub.
Como funciona
Nada muda até você aprovar um plano.
-
01
Conecte localmente
Abra a skill no seu agente ou use o app. Escolha seu provedor e informe sua credencial. A conexão é testada antes de qualquer outra coisa.
-
02
Escaneie e revise
A skill ou o app lê apenas metadados de cabeçalho: remetente, assunto, data, tamanho e flags. Mostra categorias, e-mail protegido, destinos e alvos de descadastro. Nada muda ainda.
-
03
Mova um lote pequeno
Aplique alguns movimentos. O journal registra a execução e o Desfazer a restaura. Revise o resultado antes de cuidar do descadastro separadamente.
Provedores
Funciona com o seu provedor.
Sem migração. Você precisa de acesso IMAP e do método de autenticação que o seu provedor permite.
GmailSenha de app + 2FA
Outlook / Microsoft 365Microsoft 365: consentimento do admin
YahooSenha de app
iCloudSenha específica de app
FastmailSenha de app + Sieve
ProtonProton Bridge
Qualquer servidor IMAP com UIDPLUS ou MOVE e com as pastas Trash, Junk e Archive resolvíveis funciona. Notas sobre provedores · status de validação.
Nomes e logotipos de provedores são marcas dos respectivos proprietários.
Segurança
Revise primeiro. Desfaça os movimentos.
Nenhuma exclusão permanente
Não existe comando de exclusão permanente. O CleanYourMail nunca esvazia as pastas Trash ou Junk e nunca executa um expunge em toda a caixa.
Só cabeçalhos
Lê remetente, assunto, data, tamanho, flags e cabeçalhos de descadastro, e armazena esses metadados localmente. Nunca baixa corpos nem anexos.
E-mail protegido fica onde está
E-mails pessoais, transacionais, de segurança, bancários, faturas, viagens, saúde, governo, jurídicos, marcados com estrela, respondidos e recentes ficam excluídos de movimentos automáticos e pedidos de descadastro.
Revise, mova, desfaça
scan, report e plan não mudam nada. Revise o plano, comece com um movimento pequeno e use o journal e o undo para restaurar aquela execução. O descadastro é separado e irreversível.
Roda localmente: nenhum serviço CleanYourMail hospedado, nenhuma conta, nenhuma telemetria. Inspecione o código, o modelo de segurança e os testes.
FAQ
Perguntas antes de conectar.
Isso exclui e-mails?
Não. Não há comando de exclusão permanente, nunca esvazia as pastas Trash ou Junk e nunca executa um expunge em toda a caixa. Movimentos e arquivamentos ficam registrados no journal; pedidos de descadastro não são reversíveis.
O que ela lê?
Apenas cabeçalhos: remetente, assunto, data, tamanho, flags e cabeçalhos de descadastro. Nunca baixa corpos nem anexos. O cache local guarda metadados, não o corpo das mensagens.
Preciso ser técnico?
O app é o caminho simples. A skill, o produto principal, precisa de um agente de código com acesso ao shell. A CLI é para desenvolvedores que preferem o terminal. Todos os três usam o mesmo modelo de plano e desfazer.
Funciona com o meu provedor?
Gmail, Outlook/Microsoft 365, Yahoo, iCloud, Fastmail, Proton Bridge e servidores IMAP personalizados compatíveis. O Gmail precisa de uma senha de app com verificação em duas etapas; o login do Microsoft 365 exige consentimento do administrador do tenant; o Outlook.com pessoal exige um editor verificado (verified publisher, pendente); o Proton precisa do Bridge. Movimentos em IMAP personalizado exigem UIDPLUS ou MOVE. Políticas do provedor ou do tenant podem bloquear o acesso; a ferramenta não contorna essas políticas.
E se algo der errado?
Pare e inspecione o erro. A skill, a CLI e o app verificam o plano novamente antes de aplicá-lo e registram cada execução. Use o comando undo exibido para restaurar os movimentos daquela execução. Se uma mensagem não puder mais ser encontrada, o journal continua disponível para recuperação manual. Pedidos de descadastro não podem ser desfeitos.
É realmente grátis?
Sim. Licença MIT, sem plano pago, sem conta CleanYourMail e sem telemetria. Você fornece o computador, a instalação do Python e o acesso ao provedor de e-mail.
Feedback
Diga o que devemos corrigir.
Encontrou um bug ou tem uma ideia? Envie para o Discord do CleanYourMail. Nada é enviado automaticamente: escreva os detalhes, aceite a linha de consentimento e clique em Enviar. Remova tudo o que não quiser enviar e nunca inclua senhas, tokens ou o conteúdo completo de mensagens.
Comece com um plano.
Nada muda até você dizer sim.
Grátis e de código aberto. Sem conta, sem telemetria e sem exclusão permanente.