dross is the scum that floats to the top of molten metal in a blast furnace.
It removes only what it can prove is worthless and regenerable — and tells you what it is about to do before touching a single byte.
Not all caches are created equal. A Go compile cache is worthless disk weight; a 15GB HuggingFace model or Docker volume represents bandwidth and human hours.
Trivially regenerable caches with zero download penalty. Rebuilds transparently on next build or install command.
Regenerable, but consumes noticeable internet bandwidth or compilation time when rebuilt. Skim only when disk is tight.
Operations that touch recoverable state, logs, or orphan packages. Never automated without conscious operator intent.
A disk cleaner that gets cute with wildcards is a time-bomb. dross is built on defensive systems invariants.
Running dross without arguments performs a dry-run scan. Even dross plan <tier> only lists planned deletions. Deletion requires the explicit verb clean.
Every path is checked before deletion. Rejects paths outside $HOME and /tmp, paths shallower than 3 components (e.g. ~/.cache is rejected), and any path with a symlink at or above it.
No assumed numbers. Target sizes are measured with real du before and after. If a directory still exists after removal, dross flags a hard failure and exits with status 1.
Volumes routinely host real production test databases. dross reports total reclaimable space and dangling counts, but refuses to prune docker volumes automatically.
Every execution is appended to $XDG_STATE_HOME/dross.log with the exact resolved timestamp, path, command, and measured freed space. Zero mystery.
No sprawling JSON or YAML files that silently rot. The rules table is compiled directly into the binary in src/rules.rs. What was compiled is exactly what runs.
WSL stores Linux partitions inside dynamic ext4.vhdx files on NTFS.
When you run rm -rf inside Linux, the ext4 filesystem frees inode blocks,
but the Windows Virtual Hard Disk (.vhdx) never shrinks on its own.
After cleaning with dross, run this one-line command in Windows PowerShell to compact the VHDX: