Home audit
--audit lists the 20 largest entries in $HOME, sorted by size. It deletes nothing and it does not
care whether the tool can clean what it finds.
linux-cleanup --audit
Why this is different from --scan
--scan measures the categories linux-cleanup knows how to clean. --audit measures your home
directory, full stop.
That difference is the point. If a 60 GB VM image, a downloaded dataset, or a Steam library is what actually
filled your disk, --scan will never mention it and --audit will put it at the top of the list.
--audit | --scan | |
|---|---|---|
| Scope | Everything in $HOME | Only cleanable categories |
| Answers | What is using my disk? | What can this tool reclaim? |
| Writes a JSON session report | No | No |
| Deletes | Never | Never |
The usual workflow
linux-cleanup --audit # what is big?
linux-cleanup --scan # what can this tool reclaim?
If the audit's top entries appear in the scan, the tool can help. If they do not, you have learned something more useful — the space is somewhere this tool does not go, and you can deal with it directly.
Common large things linux-cleanup will not clean:
- VM images and container storage (
~/.local/share/libvirt,~/.local/share/docker) - Game libraries (Steam, Lutris)
- Datasets, model weights, media libraries
- Anything in
~/Documents,~/Pictures,~/Music,~/Videos— all protected
Following up on a finding
du -sh ~/.local/share/* | sort -rh | head -20
du -sh ~/* | sort -rh | head -20
--audit is the fast first pass; du narrows it down once you know where to look.
Next
- Scan — what the tool can reclaim
- Reclaim the most space