rip 1.0.1

Fast, safe, and beautiful CLI & TUI cleanup tool for macOS, Windows, and Linux (Review, Inspect, Purge).

RIP — Review, Inspect, Purge (rip)

Fast, safe, and beautiful CLI & TUI cleanup tool for macOS, Windows, and Linux, written in Dart with Nocterm.

rip is a full-fledged system and software project cleanup tool. Inspired by Mole, rip scans and safely reclaims gigabytes of disk space while guaranteeing system safety through strict path validation and user whitelist protections.

---

🚀 Features

• 🖥️ Interactive Nocterm TUI: Sleek 2-pane terminal user interface with compact borders, powered by nocterm: ^0.8.0.
• ⚡ Concurrent Parallel Scanning: Scans all 7 categories concurrently in parallel via Future.wait for maximum speed.
• 📡 Live Streaming & Animated Spinner: Real-time streaming item discovery with live jumping item counts, byte sizes, and smooth braille dot spinners (⠋).
• 🛡️ Safety-First Design: Guarantees zero accidental deletions of active user documents, code, or OS binaries. Trash & Downloads and Leftovers are safely un-checked by default.
• ⚙️ System & App Caches: Reclaims caches from VS Code, Xcode, Zed, Slack, Discord, Telegram, Zoom, Spotify, Chrome, Safari, Firefox, Arc, etc.
• 🛠️ Developer Tooling: Cleans Xcode DerivedData, Simulator logs, Rust/Cargo caches, Go build caches, npm/yarn/pnpm/Bun caches, Pip/Poetry caches, CocoaPods, and Maven/Gradle repositories.
• 📦 Project Artifact Purge: Deep-scans code directories for heavy build folders (node_modules, target, build, .dart_tool, dist, .next, .nuxt, venv, etc.).
• 🗑️ Trash & Installers: Cleans system Trash and removes leftover installer files (.dmg, .pkg, .iso, .msi, .deb, .rpm, .AppImage) in Downloads.
• 🧹 Uninstalled App Leftovers: Scans for orphaned configuration and cache folders left behind by uninstalled applications.
• 🛡️ Whitelist Protection: Exclude custom paths or directories persistently (~/.sofluffy/rip/whitelist.json).
• 📜 Operation Audit History: Records all cleanup runs with size saved breakdown (~/.sofluffy/rip/history.json).

---

📥 Installation & Running

Run directly via Dart

dart run bin/rip.dart           # Launch Nocterm Interactive TUI

Global Install

dart pub global activate --source git https://github.com/simonpham/rip.git
rip                             # Launch interactive TUI anywhere

---

💻 CLI Commands

1. Interactive Terminal UI (TUI)

rip

Keybindings:

• Tab: Switch focus between Categories and Items
• ← / → (or h / l): Move focus between Category and Detail panes
• ↑ / ↓ (or k / j): Navigate items
• Space / Enter: Toggle selection (also supports mouse clicks)
• S: Cycle size sorting mode (largest first → smallest first → default)
• A: Toggle Select All / None
• N: Unselect All
• C: Execute Safe Cleanup
• D: Run Dry-Run Simulation
• W: Toggle Whitelist on item / Open Whitelist View
• r: Refresh active focused category
• Shift + R: Rescan all categories
• Esc / X: Cancel background scan
• Q: Quit

2. CLI Clean

rip clean                     # Scan & clean system & app caches
rip clean --dry-run           # Preview cleanup without deleting files
rip clean -y                  # Auto-confirm cleanup
rip clean -c system -c dev    # Filter by specific categories
rip clean --json              # Output result as JSON

3. Project Build Artifact Purge

rip purge                     # Purge build folders in current directory
rip purge /path/to/code       # Target specific workspace folder
rip purge --all               # Purge build folders across all workspace directories (~/Projects, etc.)
rip purge --dry-run           # Dry-run preview

4. System Scan

rip scan                      # Print scan report and reclaimable space
rip scan --json               # Output scan report as JSON

5. Manage Whitelist

rip whitelist                 # List whitelisted path exclusions
rip whitelist add ~/Projects  # Whitelist a folder or file
rip whitelist remove ~/Path   # Remove folder from whitelist

6. View History

rip history                   # View past cleanup logs and total space freed

---

📄 License

Licensed under the MIT License. Repository: https://github.com/simonpham/rip