# dust
> A more intuitive version of du written in Rust

## Summary
A modern du replacement that shows disk usage with visual bar charts. Automatically sorts by size and displays a tree-like structure for easy comprehension.

## Capabilities
- Visual bar chart display of disk usage
- Automatic sorting by size (largest first)
- Tree-like directory structure output
- Configurable depth and number of results

## When to Use
- Finding what's taking up disk space
- Need a quick visual overview of directory sizes
- Want sorted disk usage without piping du through sort

## When NOT to Use
- Need machine-parseable output for scripts (use du)

## Usage Patterns
### Show disk usage of current directory
```
dust
```
Displays a visual tree of directory sizes sorted by size

### Limit depth and show top entries
```
dust -d 2 -n 10
```
Shows top 10 entries with max depth of 2 levels

## Input / Output
- **stdout**: Visual bar chart of disk usage

## Installation
- **homebrew**: `brew install dust`
- **cargo**: `cargo install du-dust`
- **pacman**: `sudo pacman -S dust`

## Related Tools
- [duf](/tools/duf) (complementary): duf shows filesystem-level disk usage, dust shows directory-level

---
Source: https://littlescripts.sh/tools/dust
