Automates safe repository cleanup and de-bloating through a strict inventory-and-approval workflow.
The Janitor skill provides a safety-first protocol for managing repository bloat and cleaning up workspace clutter within Claude Code. It follows a strict 'inventory-approve-act' workflow, ensuring that no files are deleted without explicit user consent. By defaulting to reversible actions—moving candidates to a timestamped trash directory—and offering clear rollback commands, it allows developers to reclaim disk space and remove duplicates from build artifacts, logs, and backups without the risk of accidental data loss.
Key Features
01Reversible staging by moving files to a dedicated, timestamped trash directory.
02Smart detection of build artifacts, logs, and duplicate backup files.
030 GitHub stars
04Multi-stage safety protocol: Inventory, Propose, Approve, and Execute.
05Automatic generation of rollback commands for instant data restoration.
06Safe script generation for cleanup tasks requested outside the repository scope.
Use Cases
01Decluttering repositories by identifying and moving redundant backup files.
02Safely purging untracked large directories that cause snapshot or git warnings.
03Reclaiming disk space by removing old build artifacts and regeneratable reports.
