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.
cargo install ruhsTo disable parallel scanning:
cargo install ruhs --no-default-features# 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 --jsonFind 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 |
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 |
- 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
MIT