filedust 0.1.0

Opinionated junk cleaner for dev machines (caches, build artifacts, editor backups).

filedust

filedust is a small, fast, and safe command-line tool that scans your filesystem for obvious junk — things like Python pycache folders, build artifacts, editor backup files, and leftover temporary files — and cleans them up.

Think of it as “autoremove for files.”

Features

Cleans common junk

Deletes well-known clutter such as:

• __pycache__/

• .pytest_cache, .mypy_cache, .ruff_cache

• build/, dist/

• editor backups *~, *.swp, *.tmp, etc.

• OS metadata like .DS_Store, Thumbs.db

Rich, colorful table output

It wasn't essential, but it's easy to read at a glance.

Single confirmation prompt

One interactive prompt at the end of the run (unless -y is used).

Reclaimed space summary

Shows how much disk space can be freed.

Safe by design

Never touches dotfiles, configs, project files, or anything important.