Quickstart

Run without installing

pipx run killpy --path ~

uvx killpy --path ~

The --path option controls the filesystem root scanned by the TUI or command.

killpy

killpy --path ~/projects

The TUI starts immediately and streams results as detectors finish. You do not need to wait for the full scan to complete before browsing rows.

List everything under a path:

killpy list --path ~/projects

Preview a cleanup without deleting anything:

killpy delete --path ~/projects --dry-run

Show size totals grouped by type:

killpy stats --path ~/projects

Remove __pycache__ directories recursively:

killpy clean --path ~/projects

The top-level command also provides a bulk delete mode:

killpy --path ~/projects --delete-all

killpy --path ~/projects --delete-all --yes

Use this mode carefully. It scans first, prints the candidates, and optionally asks for confirmation before deleting them all.