ruhs 0.1.1

Find largest files and directories
ruhs-0.1.1 is not a library.

ruhs

Find the largest files and directories. A fast, cross-platform CLI tool written in Rust with optional parallel scanning, progress bars, and color-coded output.

Installation

cargo install ruhs

To disable parallel scanning:

cargo install ruhs --no-default-features

Usage

# Find largest files in current directory
ruhs files

# Find largest directories
ruhs dirs

# Top 20 largest files in /var
ruhs files -n 20 /var

# Directories 2 levels deep
ruhs dirs -d 2

# Exclude common junk (.git, node_modules, __pycache__, etc.)
ruhs files -x

# Only show files >= 100MB
ruhs files -m 100M

# JSON output for scripting
ruhs files --json

Commands

ruhs files [DIRECTORY]

Find the largest files in a directory.

Option Description
-n, --number N Number of results (default: 10)
-a, --all Show all results
-e, --exclude PAT Exclude pattern (repeatable)
-x, --exclude-common Exclude .git, node_modules, pycache, etc.
-m, --min-size SIZE Minimum size (e.g., 1M, 500K, 1G)
-j, --json Output as JSON
--no-progress Disable progress bar

ruhs dirs [DIRECTORY]

Find the largest directories.

Option Description
-n, --number N Number of results (default: 10)
-a, --all Show all results
-d, --depth N Directory depth (default: 1)
-e, --exclude PAT Exclude pattern (repeatable)
-x, --exclude-common Exclude .git, node_modules, pycache, etc.
-m, --min-size SIZE Minimum size (e.g., 1M, 500K, 1G)
-j, --json Output as JSON
--no-progress Disable progress bar

Features

  • Parallel directory scanning via rayon (enabled by default, disable with --no-default-features)
  • Progress spinner with real-time item count
  • Color-coded output (GB=red, MB=yellow, KB=cyan)
  • Accurate disk usage (block allocation, not apparent size) on macOS/Linux
  • Cross-platform (macOS, Linux, Windows)
  • JSON output for scripting

License

MIT