fengyiqicoder/MacAutoClean

O que MacAutoClean faz?

Habilidade de código Claude de código aberto para limpeza automatizada e segura de armazenamento no macOS — 48 categorias, conselheiro inteligente para pastas não utilizadas (LLMs locais, VMs, node_modules obsoletos) e limpeza automática programada via launchd.

Visão Geral

MacAutoClean é uma ferramenta poderosa que se integra ao Claude Code para ajudar você a gerenciar e limpar o armazenamento do seu Mac de forma inteligente. Ela foi projetada para desenvolvedores que acumulam muitos arquivos temporários, caches e dependências de projetos.

Funcionalidades

• 48 Categorias de Limpeza: Abrange desde caches do sistema, logs, lixo do navegador até dependências de desenvolvimento.
• Conselheiro Inteligente: Analisa pastas não utilizadas, como modelos de LLMs locais, discos de VMs e node_modules obsoletos, e sugere quais remover.
• Limpeza Automática Programada: Configure jobs launchd para executar limpezas regulares automaticamente.
• Segurança: Verificações rigorosas para evitar a exclusão de arquivos importantes.

Plataformas Suportadas

• macOS (testado no macOS Ventura e superiores)
• Funciona com Claude Code (CLI)

Como Usar

Instalação

Clone o repositório e adicione ao seu projeto Claude:

git clone https://github.com/fengyiqicoder/MacAutoClean.git
cd MacAutoClean

Comandos Básicos

• mac-clean analyze – Analisa o armazenamento e mostra categorias de limpeza.
• mac-clean clean [categoria] – Limpa uma categoria específica.
• mac-clean advisor – Executa o conselheiro inteligente para pastas não utilizadas.
• mac-clean schedule – Configura limpeza automática via launchd.

Exemplo de Uso

# Analisar o armazenamento atual
mac-clean analyze

# Limpar caches do sistema
mac-clean clean system-caches

# Verificar pastas não utilizadas
mac-clean advisor

# Agendar limpeza semanal
mac-clean schedule --interval weekly

Configuração

Você pode configurar a habilidade através de variáveis de ambiente ou um arquivo de configuração:

• MAC_CLEAN_EXCLUDE – Lista de pastas para excluir da limpeza.
• MAC_CLEAN_SCHEDULE – Intervalo de agendamento (daily, weekly, monthly).

Licença

MIT

Contribuição

Contribuições são bem-vindas! Consulte o arquivo CONTRIBUTING.md para mais detalhes.