Scripts Bash para liberar espaço em disco, limpar cache de IDEs, Docker, node_modules e otimizar o diretório home no Linux.
Guia de Limpeza | Problemas do VS Code | Casos de Uso | Contribuir
| Problema | Solução |
|---|---|
| VS Code consumindo 10GB+ de cache | Script limpa cache de Code, Cursor, Windsurf |
| Docker.raw crescendo infinitamente | Reset seguro do disco virtual Docker |
| node_modules de projetos antigos | Identificação e remoção automática |
| Snaps ocupando espaço duplicado | Remoção de revisões desabilitadas |
| Não sabe onde está o espaço | Análise detalhada com sugestões |
"Eu estava cansado de ver aquela notificação irritante do Ubuntu: 'Espaço em disco insuficiente'. Aparecia toda semana, sempre no pior momento — no meio de um deploy, compilando um projeto, ou durante uma reunião importante. Eu perdia horas tentando descobrir o que estava consumindo meu SSD de 500GB, deletava alguns arquivos aleatórios, e duas semanas depois... a notificação voltava.
Cansei. Decidi investigar a fundo e descobri que o problema não eram meus arquivos — eram caches ocultos de IDEs, Docker inflado, e node_modules de projetos que eu nem lembrava que existiam. Criei estes scripts para resolver de uma vez por todas. Na primeira execução, recuperei 165GB de espaço. Nunca mais vi aquela notificação."
— Johnny, Desenvolvedor Full Stack & Linux Specialist
| Categoria | Espaço | % |
|---|---|---|
| Docker (imagens/volumes/Docker.raw) | 67 GB | 40.6% |
| Caches de IDEs (VS Code, Cursor) | 34 GB | 20.6% |
| node_modules de projetos antigos | 28 GB | 17.0% |
| Cache do sistema (~/.cache) | 19 GB | 11.5% |
| Snaps desabilitados | 12 GB | 7.3% |
| Outros (pip, gradle, thumbnails) | 5 GB | 3.0% |
# Clone o repositório
git clone https://github.com/johnnyvaz/linux-home-cleanup.git
cd linux-home-cleanup
# Dê permissão de execução
chmod +x *.sh scripts/*.sh
# Execute a análise inicial
./analise-espaco.sh- Sistema: Ubuntu 20.04+, Linux Mint, Pop!_OS ou derivados Debian
- Shell: Bash 5.0+
- Ferramentas:
du,find,numfmt,awk(pré-instalados) - Opcional:
docker,snap,npm,pip
Diagnóstico completo do seu diretório home com relatórios visuais.
./analise-espaco.sh # Analisa $HOME
./analise-espaco.sh /caminho # Analisa diretório específicoO que analisa:
- Distribuição de espaço por diretório (Top 20)
- Arquivos grandes (>100MB)
- Arquivos por tipo: vídeos, imagens, áudio, documentos
- Arquivos antigos sem acesso (>180 dias)
- Sugestões de otimização e backup
Menu interativo para limpeza segura com confirmações.
./limpeza-geral.sh # Menu interativo
./limpeza-geral.sh --all # Todas as limpezas
./limpeza-geral.sh --vscode # Apenas cache de IDEs
./limpeza-geral.sh --analyze # Análise de extensõesO que limpa:
- Cache de VS Code, Cursor, Windsurf, Antigravity
- Cache Python (pycache, pip)
- Cache Java/Gradle/JetBrains
- Cache Node.js (npm)
- Sistema (apt, journalctl)
- Docker
Para recuperar espaço significativo com operações avançadas.
./limpeza-profunda.shO que limpa:
- Docker completo (incluindo Docker.raw)
- Snaps desabilitados
- Cache completo (~/.cache)
- APT e logs do sistema
Gera relatório estruturado para análise com ChatGPT, Claude ou Gemini.
./scripts/analise-ia.sh > relatorio.txt
# Cole no seu assistente de IA para recomendações personalizadas# Passo 1: Diagnosticar
./analise-espaco.sh
# Passo 2: Limpeza conservadora (primeira vez)
./limpeza-geral.sh
# Passo 3: Limpeza profunda (se precisar mais espaço)
./limpeza-profunda.sh
# Passo 4: Agendar manutenção mensal
echo "0 10 1 * * ~/linux-home-cleanup/analise-espaco.sh" | crontab -| Documento | Descrição |
|---|---|
| GUIA-LIMPEZA.md | Tutorial completo de limpeza passo a passo |
| PROBLEMAS-VSCODE.md | Por que VS Code consome tanto espaço |
| CASOS-DE-USO.md | 8 cenários reais com soluções |
IDEs baseados em VS Code são os maiores vilões do consumo de espaço:
~/.config/Code/ → 5-15 GB (cache, logs, extensões)
~/.vscode/extensions/ → 1-5 GB (extensões instaladas)
~/snap/code/ → 8-20 GB (se instalado via Snap)
Usando múltiplos IDEs? Multiplique por 2, 3 ou 4:
- VS Code + Cursor + Windsurf = 30-50GB de cache!
Veja a documentação completa: PROBLEMAS-VSCODE.md
Este repositório foi criado como material de estudo. Use para:
- Aprender Bash - Estude os scripts e entenda cada comando
- Referência rápida - Consulte quando precisar limpar seu sistema
- Base para projetos - Fork e adapte para suas necessidades
- Execute
analise-espaco.she analise o relatório - Identifique os 3 maiores consumidores no seu home
- Use
limpeza-geral.she registre quanto liberou - Adicione uma nova funcionalidade via Pull Request
linux-home-cleanup/
├── analise-espaco.sh # Análise de espaço
├── limpeza-geral.sh # Limpeza interativa
├── limpeza-profunda.sh # Limpeza avançada
├── scripts/
│ └── analise-ia.sh # Relatório para IA
├── docs/
│ ├── GUIA-LIMPEZA.md # Guia completo
│ ├── PROBLEMAS-VSCODE.md # Documentação VS Code
│ └── CASOS-DE-USO.md # Casos de uso
├── .github/
│ └── ISSUE_TEMPLATE/ # Templates de issues
├── README.md
├── CONTRIBUTING.md
├── LICENSE
└── CLAUDE.md
Contribuições são bem-vindas! Veja CONTRIBUTING.md.
- Fork o repositório
- Crie uma branch:
git checkout -b feature/minha-feature - Commit suas mudanças:
git commit -m 'feat: adiciona X' - Push:
git push origin feature/minha-feature - Abra um Pull Request
Liberou espaço com estes scripts? Abra uma issue contando quanto!
Faça backup de dados importantes antes de executar limpezas
Leia as confirmações - Os scripts pedem confirmação antes de deletar
Docker.raw - O reset apaga TODAS as imagens e volumes Docker
MIT License - Use, modifique e distribua livremente.
Johnny - Desenvolvedor Full Stack & Linux Specialist
Experiência com sistemas Linux desde 2010. Especialista em automação e otimização de sistemas.
Se este projeto te ajudou a recuperar espaço em disco e resolver problemas, considere apoiar com um cafezinho! ☕
pix@cd2.io
Outras formas de apoiar:
- ⭐ Deixe uma estrela neste repositório
- 🐛 Reporte bugs e sugira melhorias
- 📖 Compartilhe com outros desenvolvedores
- 💻 Contribua com código (veja como)
linux ubuntu bash cleanup disk-space cache vscode docker node-modules system-maintenance devops automation shell-script home-directory storage optimization snap apt developer-tools
Após criar o repositório, configure:
Description:
Scripts Bash para limpeza e otimização do Linux Ubuntu. Libere espaço limpando cache de VS Code, Docker, node_modules e mais. Toolkit completo com análise, limpeza e documentação.
Topics (adicione no GitHub):
linux, ubuntu, bash, cleanup, disk-space, cache-cleaner, vscode, docker,
node-modules, shell-script, devops, automation, system-maintenance,
storage-optimization, developer-tools, linux-mint, pop-os, debian
Website: Link para a documentação principal ou seu perfil
Se este projeto te ajudou, deixe uma estrela!
