Automation

killpy can be used as an interactive cleanup tool, but it also has enough CLI surface for automation.

Inventory jobs

Generate machine-readable output:

killpy list --path ~/projects --json

Stream results progressively:

killpy list --path ~/projects --json-stream | jq

Reporting jobs

Aggregate environment size by type:

killpy stats --path ~/projects --json

Scheduled cleanup previews

Preview deletions before applying them:

killpy delete --path ~/projects --older-than 180 --dry-run

Bulk cleanup

For explicit scripted cleanup:

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

Use that mode only when the scan root and retention policy are already controlled elsewhere.