v0.2.2·Rust + GPUI·macOS · Linux · Windows · GPL-3.0

Make room onevery drive.

See what fills local disks, Docker storage, and remote SSH servers in a proportional GPUI treemap. Let the O(1) AI Watchdog and MCP server prepare proposals — nothing is removed until you confirm.

Interactive demo + unedited macOS screenshot toggle below — or launch the 5-step Quick Start

curl -fsSL https://ruum-updates.jsonlee12138.com/install.sh | sh
ruumSample data
ruum / Users / dev263 GiB · 4,184,346 files · 63.0 s
Hatched = Reclaimable
SelectionReclaimable

Library/Caches

15.0 GiB

~/Library/Caches

Of scan5.7%
Files184,920
Last write11m ago
KindCache
Git safety:Not a repository
Worth a look82.1 GiB
Disk · /dev/disk3s554.0 GiB free → 77.4 GiB after cleanup
Four Core Pillars

Built for AI-era workstations and production servers.

Every capability is engineered to make multi-gigabyte storage bottlenecks immediately legible — without risking uncommitted code, Docker volumes, or wrong SSH hosts.

01 · AI Intelligence & MCP

Watchdog daemon + 8-tool stdio MCP server.

An O(1) background watchdog detects low free space without burning disk I/O, asks your configured AI CLI (Agy, Pi, Codex, or Custom) for candidates, and exposes 8 typed MCP tools with hard human approval gates.

  • OS-native daemon: launchd (macOS), systemd --user (Linux), zero-UAC Run key (Windows)
  • AI proposals always open a standalone Confirm Cleanup dialog with Git dirty warnings
  • Mutating MCP tools fail closed without desktop checkbox approval + OS Touch ID auth
{
  "mcpServers": {
    "ruum": {
      "command": "ruum",
      "args": ["mcp"]
    }
  }
}
Headless stdio MCP · zero GUI startupHuman-gated
Exposed MCP Tools (8)ruum mcp
ToolScopeSafety Boundary
list_volumesLocal / SSHRead-only mount probe; zero file walk
scan_directoryLocal / SSHRead-only scan; cached in session
inspect_subtreeLocal / SSHRead-only tree lookup & substring search
find_reclaimableLocal / SSHHeuristics: caches, build dirs, stale worktrees
check_git_safetyLocal onlyHook-free Git status; rejects ssh_host
plan_removalLocal / SSHDry-run against safety guards; never deletes
trash_pathsLocal / SSHGUI Confirm Cleanup checkbox approval required
delete_permanentlyLocal onlyGUI approval + OS native auth (Touch ID)
02 · Remote SSH Diagnostics

Zero-sudo static musl streaming over SSH.

Point ruum at any SSH host alias. Packaged builds upload a checksum-verified static musl binary into ~/.cache/ruum/ssh/ and stream bounded records without storing the tree in remote RAM.

  • Stops at nested mount points and terminates cleanly on disconnect
  • Remote GUI is strictly export-only — no direct remote delete buttons
  • Generated scripts check actual remote hostname & machine-id before deleting anything
01
Probe & Upload
Detects OS/arch, uploads verified static musl scanner (~/.cache/ruum/ssh)
02
Bounded Stream
Single compressed SSH pipe; zero full-tree remote memory footprint
03
HostIdentity Guard
Preview-first script aborts on hostname or /etc/machine-id mismatch
One command from any terminal
ruum ssh user@server /var  # && --check for headless summary
03 · Docker Space & Volume Safety

Inspect images, containers & build cache — never touch volumes.

Built-in Docker workspace works identically on local Docker Desktop / OrbStack and remote SSH daemons, separating shared image layers from safe reclaimable build cache.

  • Four-state daemon probe: NotInstalled, DaemonStopped, PermissionDenied, Available
  • Distinguishes unique vs. image-shared Build Cache bytes accurately
  • Local Volumes remain strictly Protected · Read-only across GUI and cleanup adapters
ImagesReclaimable

Unused & dangling selectable

ContainersReclaimable

Stopped / exited candidates

Build CacheReclaimable

Unique vs shared layers split

Local VolumesProtected · Read-only

Never auto-pruned by ruum

04 · Native GPUI Visualization

Colour means category. Hatch means reclaimable.

Rendered natively in Rust with GPUI. Tile area maps to real allocated disk blocks (plus NTFS MFT direct read on Windows), while diagonal hatching lets you spot safe cleanups instantly.

  • Memoized widening from ~ to / reuses scanned subtrees without re-walking
  • Hardlink deduplication counts shared inodes once during bottom-up aggregation
  • Live free-space projection meter prevents double-counting nested marks
Category Colour Map10 categories
Code
Agent scratch
Toolchains
Container
Synced
Git
Media
Cache
Documents
Other
45° Hatch = Reclaimable cache, build output, worktree, or package store
Engineering Guardrails

Safety enforced in Rust, not wishful UI prompts.

Every removal is validated in Rust before touching disk and aborts automatically if any boundary is violated.

GUARD · 01

OS & Mount-Point Refusal

Filesystem root, home directory, /usr, /etc, /nix/store, Homebrew prefixes, and Windows system trees are unconditionally blocked.

GUARD · 02

Docker Volume Read-Only Lock

Local volumes are excluded from cleanup at the core level — database and persistent mounts cannot be selected or pruned.

GUARD · 03

Cloud-Safe & Hardlink Aware

Never triggers iCloud Drive or Dropbox hydration downloads; excludes Time Machine local snapshots; deduplicates hardlinked inodes.

GUARD · 04

Hook-Free Git Inspection

Evaluates dirty trees, stashes, and unpushed commits with hooks, fsmonitor, and custom filter drivers disabled.

GUARD · 05

Human & Touch ID Gate

Trash is default; permanent deletion and mutating MCP calls require GUI checkbox approval plus OS native authentication.

GUARD · 06

Signed Releases & Attestation

Every release ships Ed25519 manifests, SHA256SUMS, and Sigstore provenance verifiable via gh attestation verify.

Ready in 15 seconds

Reclaim disk space on local drives and remote servers.

Single binary with desktop GUI, SSH scanner, Watchdog daemon, and stdio MCP server built in.

curl -fsSL https://ruum-updates.jsonlee12138.com/install.sh | sh