filedust 0.3.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

• It ONLY runs within user's $HOME

• Put user in control by reading ~/.filedust.conf

• Never touches dotfiles, configs, project files, or anything important unless you want.

Installation

From PyPI

pip install filedust

From this repository

git clone https://github.com/guardutils/filedust.git
cd filedust/
poetry install

Custom config

You can download the example and add your custom rule

wget -O ~/.filedust.conf https://raw.githubusercontent.com/guardutils/filedust/main/.filedust.conf.example

TAB completion

Add this to your .bashrc

eval "$(register-python-argcomplete filedust)"

And then

source ~/.bashrc