convez.ai
SkillDevOps & InfraestruturaIntermediário
leo-younger

Claude Project Cleaner

leo-younger/claude-project-cleaner

Limpeza inteligente de projetos baseada em transcript da sessão atual

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-cleaner

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 TimeWhat Happens
Every session endRecords timestamp (Stop hook)
7 days idleNudge on next session start
30 days idleAuto-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

Ver o original no GitHub

Bom para

Relacionados