rasa 0.3.1

A plugin-based disk space cleaner for developers
rasa-0.3.1 is not a library.

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

  • 53 plugins — languages, package managers, databases, 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

cargo install rasa
git clone https://github.com/hpouillot/rasa.git
cd rasa
cargo install --path .

Quick start

# 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:

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

CLI flags always take precedence.

Plugins

Use plugin IDs with --only and --skip flags (e.g. rasa --only node,cargo,docker).

Category Plugin ID Description
Languages & runtimes cargo Rust build artifacts and registry cache
dotnet .NET build outputs and NuGet cache
go Go module cache and build cache
python Virtual environments and __pycache__
ruby Gem cache and bundle artifacts
swift Swift Package Manager cache
typescript TypeScript build info files
Package managers bun Bun install cache
cocoapods CocoaPods cache
gradle Gradle caches and build outputs
homebrew Homebrew cache and old versions
maven Maven local repository
nix Nix store garbage
node node_modules directories
node-gyp Native addon build artifacts
pip pip download and wheel cache
pnpm pnpm global store
yarn Yarn cache
Build tools cmake CMake build directories
sccache Shared compilation cache
turborepo Turborepo cache
Databases mysql MySQL / MariaDB data files
postgres PostgreSQL data and WAL files
sqlite SQLite temporary and WAL files
Containers & VMs docker Docker build cache and unused data
orbstack OrbStack disk images
AI / ML claude Claude desktop cache
jupyter Jupyter runtime and data files
ollama Ollama model cache
Browsers brave Brave browser cache
chrome Chrome browser cache
firefox Firefox browser cache
safari Safari cache and data
Apps android Android SDK and emulator images
cypress Cypress binary cache
electron Electron app cache
flox Flox environment cache
iterm2 iTerm2 cache
linear Linear app cache
playwright Playwright browser binaries
proton Proton Mail cache
slack Slack app cache
spotify Spotify cache and data
tableplus TablePlus cache
terraform Terraform plugin cache
xcode Xcode derived data and archives
zed Zed editor cache
zoom Zoom app cache
System downloads Old files in Downloads folder
git Git repository garbage collection
image Large image files
logs System and app log files
tmp Temporary files
trash System trash
video Large video files

License

MIT