rasa 0.2.5

A plugin-based disk space cleaner for developers
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

<p align="center">
  <h1 align="center">rasa</h1>
  <p align="center">
    A fast, plugin-based disk space cleaner for developers.
    <br />
    <a href="https://crates.io/crates/rasa"><img src="https://img.shields.io/crates/v/rasa.svg" alt="crates.io"></a>
    <a href="https://github.com/hpouillot/rasa/actions"><img src="https://github.com/hpouillot/rasa/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
    <a href="LICENSE"><img src="https://img.shields.io/crates/l/rasa.svg" alt="License: MIT"></a>
  </p>
</p>

Rasa scans your filesystem for build artifacts, caches, logs, and other space hogs left behind by development tools — then lets you interactively pick what to delete.

---

## Highlights

- **50 plugins** — languages, package managers, IDEs, browsers, system caches
- **Interactive TUI** — browse, sort by size, toggle unsafe items, filter by plugin
- **Fast** — parallel filesystem walk with SQLite cache for instant re-runs
- **Safe by default** — every target is labelled *recoverable* or *unsafe*
- **Configurable** — CLI flags or `~/.rasa/config.toml`

## Installation

```sh
cargo install rasa
```

<details>
<summary>From source</summary>

```sh
git clone https://github.com/hpouillot/rasa.git
cd rasa
cargo install --path .
```
</details>

## Quick start

```sh
# Scan home directory with defaults
rasa

# Only Node and Cargo artifacts, 500 MB minimum
rasa --only node,cargo --min-size 500MB

# Scan a specific directory, skip Docker
rasa ~/Code --skip docker
```

## CLI reference

```
rasa [OPTIONS] [PATHS]...
```

| Flag | Description | Default |
|---|---|---|
| `-m, --min-size <SIZE>` | Minimum target size to report | `100MB` |
| `-d, --max-depth <N>` | Maximum directory depth to scan | `8` |
| `--only <PLUGINS>` | Only run these plugins (comma-separated) | |
| `--skip <PLUGINS>` | Skip these plugins (comma-separated) | |
| `--exclude <PATHS>` | Exclude paths from scanning (comma-separated) | |
| `--no-global` | Skip global targets, only scan project directories | |
| `--rescan` | Ignore cache and force a full rescan | |

## TUI controls

| Key | Action |
|---|---|
| `j` / `k` / `↑` / `↓` | Navigate |
| `Space` | Toggle selection |
| `Enter` | Confirm and delete |
| `s` | Cycle sort order |
| `u` | Show / hide unsafe targets |
| `e` | Show / hide explanations |
| `q` / `Esc` | Quit |

## Configuration

Create `~/.rasa/config.toml` to set persistent defaults:

```toml
min_size = "200MB"
max_depth = 6
skip = ["docker", "downloads"]
exclude = ["/mnt/external"]
no_global = true
```

CLI flags always take precedence.

## Plugins

<details>
<summary>View all 50 plugins</summary>

| Category | Plugins |
|---|---|
| **Languages & runtimes** | Cargo, Go, .NET, Python, Ruby, Swift, TypeScript |
| **Package managers** | Bun, CocoaPods, Gradle, Homebrew, Maven, Nix, Node.js, node-gyp, pip, pnpm, Yarn |
| **Build tools** | CMake, sccache, Turborepo |
| **Containers & VMs** | Docker, OrbStack |
| **AI / ML** | Claude, Jupyter, Ollama |
| **Browsers** | Brave, Chrome, Firefox, Safari |
| **Apps** | Android, Electron, Flox, iTerm2, Linear, Playwright, Proton, Slack, Spotify, TablePlus, Terraform, Xcode, Zed, Zoom |
| **System** | Cypress, Downloads, Git, Images, Logs, tmp, Trash, Videos |

</details>

## License

[MIT](LICENSE)