diskhound 0.1.1

A simple CLI tool to find the largest subdirectories
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

# diskhound

A fast CLI tool to find the largest subdirectories in a given path.

## Installation

```bash
cargo install diskhound
```

## Usage

```bash
# Scan current directory, show top 10 largest subdirectories
diskhound

# Scan a specific path
diskhound ~/Downloads

# Show only top 5
diskhound --top 5

# Combine options
diskhound ~/Library --top 20
```

## Example output

```
📁 node_modules         1.24 GiB
📁 target               847.32 MiB
📁 build                156.80 MiB
📁 dist                 42.50 MiB
📁 src                  12.30 MiB
```

## Features

- Scans immediate subdirectories and reports total size
- Human-readable size formatting (GiB, MiB, KiB)
- Does not follow symlinks
- Silently ignores permission errors
- Fast traversal using walkdir

## License

MIT