Claude Project Cleaner
leo-younger/claude-project-cleaner
Limpeza inteligente de projetos baseada em transcript da sessão atual
Ver no GitHubSkill de limpeza pós-sessão para Claude Code que analisa o transcript da conversa atual, identifica arquivos instalados, criados ou modificados nesta sessão, e oferece limpeza segura com backup e rollback. Inclui scanner global opcional para varredura profunda em 12 locais de armazenamento do Claude.
Instalação
npx convez-ai leo-younger/claude-project-cleaner1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Remover pacotes e arquivos temporários após longas sessões de desenvolvimento
- Identificar e deletar versões antigas e cache de forma segura
- Organizar e classificar artefatos de projeto em 6 categorias automáticamente
- Executar limpeza global com proteção de backup e rollback automático
Veredito

Solução prática e bem-pensada para o problema específico de clutter em sessões longas do Claude Code. Zero dependências externas e enfoque em segurança (lê transcript, respeita escopo da sessão) a tornam confiável para limpeza rotineira.
README
A tradução para o português deste README ainda está na fila.
🧹 Claude Project Cleaner
Session-scoped cleanup for Claude Code — knows exactly what THIS conversation downloaded, created, or changed. Never touches other projects.
After a long Claude Code session, you've installed packages, created files, loaded skills. What's safe to delete? This skill reads your current conversation transcript and shows only what happened in this window.
What It Does
Say "清理项目" at the end of a session
│
├── Parse current transcript (JSONL)
├── Filter out read-only operations (Read, WebSearch, etc.)
├── Show what THIS session did:
│ ├── 📦 Installed (npm install, pip install, git clone...)
│ ├── 📝 Files created (Write tool calls)
│ ├── ✏️ Files edited (Edit tool calls)
│ └── 🧠 Skills loaded
└── You decide what to clean
Never touches: other projects, other conversations, global config, global skills.
Quick Start
git clone https://github.com/leo-younger/claude-project-cleaner.git ~/.claude/skills/claude-project-cleaner
Then in any Claude Code session, say "清理项目" or "clean up project".
Or run manually:
python scripts/session_cleaner.py
python scripts/session_cleaner.py ~/.claude/projects/xxx/session.jsonl
Cooldown Auto-Cleanup (Optional)
Copy hooks.json into your project's .claude/settings.json:
| Idle Time | What Happens |
|---|---|
| Every session end | Records timestamp (Stop hook) |
| 7 days idle | Nudge on next session start |
| 30 days idle | Auto-clean cache (Category E only, safe) |
Bonus: Global Scanner (Legacy)
Also includes a full-disk scanner for deep cleaning:
python scripts/scanner.py # Scan 12 Claude Code locations
python scripts/organizer.py # Classify into 6 categories
python scripts/cleaner.py # Dry-run preview
python scripts/cleaner.py --auto # Execute with backup & rollback
Requirements
- Python 3.9+
- Zero pip dependencies (stdlib only)
License
MIT