Installation

Requirements

• Go 1.26 or later
• macOS or Linux

Install from Source

go install github.com/LarsArtmann/clean-wizard@latest

The binary is placed in $GOPATH/bin (typically ~/go/bin).

Build from Source

git clone https://github.com/LarsArtmann/clean-wizard.git
cd clean-wizard
go build -o clean-wizard ./cmd/clean-wizard/

Note: Clean Wizard uses encoding/json/v2. If building outside the Nix devShell, set GOEXPERIMENT=jsonv2:

GOEXPERIMENT=jsonv2 go build -o clean-wizard ./cmd/clean-wizard/

Nix

If using Nix flakes, enter the devShell which sets GOEXPERIMENT automatically:

nix develop
go build -o clean-wizard ./cmd/clean-wizard/

Verify Installation

clean-wizard --help

You should see the CLI help with clean and scan commands.

Next Steps

• Follow the Quick Start for usage examples
• Learn about Preset Modes for quick, standard, and aggressive cleanup
• See the CLI Reference for all flags