Skip to content
Clean Wizard

Quick Start

Interactive Mode

Section titled “Interactive Mode”

The simplest way to use Clean Wizard:

Terminal window
clean-wizard clean

This opens an interactive TUI where you select which cleaners to run. Clean Wizard auto-detects which tools are installed and only shows available cleaners.

Preset Modes

Section titled “Preset Modes”

Skip the TUI with preset modes:

Terminal window
# Quick — safe daily cleanup (Homebrew, Go, Node, TempFiles, BuildCache)
clean-wizard clean --mode quick


# Standard — all available cleaners
clean-wizard clean --mode standard


# Aggressive — everything including system caches and full Docker volumes
clean-wizard clean --mode aggressive

Dry-Run Preview

Section titled “Dry-Run Preview”

Always preview before cleaning:

Terminal window
clean-wizard clean --mode quick --dry-run

Output shows what would be cleaned and estimated space freed. No files are touched.

JSON Output

Section titled “JSON Output”

For scripts and CI/CD:

Terminal window
clean-wizard clean --json --yes

Returns machine-readable JSON with per-cleaner results:

{
  "success": true,
  "freed_bytes": 2947483648,
  "duration_ms": 3100,
  "cleaners": {
    "homebrew": { "freed_bytes": 245000000, "success": true },
    "go": { "freed_bytes": 1204000000, "success": true }
  }
}

Scan (Without Cleaning)

Section titled “Scan (Without Cleaning)”

Check what can be cleaned without running anything:

Terminal window
clean-wizard scan
clean-wizard scan --json

Skip Confirmation

Section titled “Skip Confirmation”

For automation where you have already previewed:

Terminal window
clean-wizard clean --mode quick --yes

Next Steps

Section titled “Next Steps”