ruhs 0.1.1

Find largest files and directories
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

# 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

```bash
cargo install ruhs
```

To disable parallel scanning:

```bash
cargo install ruhs --no-default-features
```

## Usage

```bash
# 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