workspace-cleanup-safe

What problem does it solve?

Perform safe, non-destructive workspace cleanup planning and execution to help users tidy disk usage, remove stale artifacts, or clean project directories without risking data loss.

Core Features & Use Cases

• Audit-first approach: read-only assessment of large files, build artifacts, temporary caches, and duplicates before any action.
• Structured plan: categorize items into Safe to delete now, Review before delete, and Keep to guide decisions.
• Safe execution with guardrails: require explicit approval before deletion and prefer reversible actions (trash/recycle) over permanent delete.
• Verification and reporting: after cleanup, report items removed, space reclaimed, and items skipped intentionally.
• Safety guardrails: never delete credentials, configuration files, or user documents by default; avoid destructive recursive deletes without explicit scoped confirmation.

Quick Start

Perform a safe, audit-first workspace cleanup by generating a plan and executing only after explicit user confirmation.