Cleaner

Ultra-fast parallel scanner and cleaner for development temp files. Instantly finds and removes .terraform, target, node_modules, __pycache__, and other build artifacts across your entire drive. Optional ncdu-style TUI for interactive browsing.

Features

• Ultra-Fast - Parallel scanning with jwalk + rayon uses all CPU cores
• Smart Deletion - Finds and removes common dev artifacts: node_modules, .terraform, target, __pycache__, etc.
• Optional TUI - ncdu-style interactive browser with instant navigation (-i flag)
• Configurable - TOML config + environment variables
• Safe - Dry-run mode and time-based filtering (--days)
• Cross-platform - Windows, Linux, macOS, FreeBSD | ARM64 and x64

Optimizations

• Parallel Scanning: Uses jwalk and rayon to utilize all CPU cores for directory traversal.
• macOS Docker Fix: Automatically detects and excludes ~/Library/Containers/com.docker.docker to prevent inflated size reporting (Docker sparse image issue).
• Protected Directories: Never scans or cleans critical toolchain directories in NON tui mode:
  • ~/.cargo, ~/.rustup (Rust)
  • ~/go, ~/.go (Go)
  • ~/.npm, ~/.nvm (Node.js)
  • ~/.pyenv, ~/.rbenv (Python/Ruby)
  • ~/.gradle, ~/.m2 (Java)
  • ~/.local, ~/.config, ~/.ssh, ~/.gnupg, ~/Library

Installation

From Releases

Download the latest binary from Releases.

From Source

cargo install --git https://github.com/vyrti/cleaner

Docker

docker pull ghcr.io/vyrti/cleaner:latest

Usage

# Quick scan and delete (defaults to home directory)
cleaner

# Scan specific folder
cleaner ~/Projects

# Preview what would be deleted (safe)
cleaner ~/Projects --dry-run

# Filter by age (only delete items older than 7 days)
cleaner ~/Projects --days 7

# Interactive TUI mode (optional - for browsing)
cleaner -i
cleaner -i ~/Projects

Options

Flag	Description
[PATH]	Target folder to scan (positional, defaults to home directory)
-i, --interactive	Optional interactive TUI mode for browsing
-d, --dry-run	Preview without deleting
-v, --verbose	Show all matched paths
-f, --folder	Target folder to scan (alternative to positional)
-c, --config	Path to TOML config file
-j, --threads	Number of threads (default: CPU cores)
--days	Only delete items older than N days

Configuration

Config File

Create cleaner.toml:

[patterns]
directories = [
    ".terraform",
    "target",
    "node_modules",
    "__pycache__",
]

files = [
    ".DS_Store",
    "*.pyc",
]

# Optional: Only delete items older than 30 days
days = 30

See cleaner.toml.example for all defaults.

Environment Variables

Override config with environment variables:

CLEANER_DIRS=".terraform,target" cleaner -f ~/Projects
CLEANER_FILES=".DS_Store,*.pyc" cleaner -f ~/Projects

Priority: Environment variables > Config file > Defaults

Default Patterns

Directories

.terraform, target, node_modules, __pycache__, .pytest_cache, .mypy_cache, .tox, .ruff_cache, venv, .venv, .eggs, *.egg-info, dist, build, .next, .nuxt, .turbo, .gradle, coverage, .coverage, htmlcov, .cache, .parcel-cache

Files

.pyc, .pyo, .pyd, .DS_Store, Thumbs.db, desktop.ini, .swp, .swo, ~

Docker Usage

# Mount directory and run
docker run -v /path/to/scan:/data ghcr.io/vyrti/cleaner -f /data --dry-run

# With env vars
docker run -e CLEANER_DIRS=".terraform,target" -v /path:/data ghcr.io/vyrti/cleaner -f /data

License

Apache 2.0