Rusty Sweeper
A fast, interactive disk usage analyzer and cleaner for Linux.
Current Status
Rusty Sweeper is implemented and test-covered across its main command surface:
rusty-sweeperis the interactive product and launches the TUI directly.rusty-sweeper-monitoris a dedicated monitor binary with one-shot checks, daemon mode, PID/log management, and multiple notification backends.
Current limitations:
- The configuration file is loaded and validated, but most command behavior is still driven directly by CLI flags rather than config values.
- Cleanup and scan engines still exist in the codebase, but they are no longer exposed as standalone CLI subcommands.
Features
- Interactive TUI: Browse disk usage and clean directly from the terminal
- Monitor Service: Background daemon with desktop notifications when disk is full
Installation
From crates.io
From Source
Usage
Interactive TUI
# Launch TUI in the current working directory
# Scan a specific directory instead of the current working directory
# `rusty-sweeper` is the only user-facing mode of the main binary
Monitor Disk Usage
# Check once and exit
# Start as daemon
# Custom thresholds (warn at 70%, critical at 85%)
# Check daemon status
# Stop daemon
Configuration
Configuration file: ~/.config/rusty-sweeper/config.toml
The file is currently loaded and validated on startup, but behavior is not yet fully driven by these values. Treat it as partially implemented.
Scanner parallelism, filesystem-boundary behavior, and the persistent metadata cache are active. Cached files are validated by device/inode, size, allocated blocks, and nanosecond modification/change times before their accounting is reused.
[]
= 0 # 0 = auto
= false
= true
= 3600
[]
= ["cargo", "gradle", "npm", "maven"]
= ["**/.git", "**/vendor"]
= 7
= 10
= 4
[]
= 300 # seconds
= 80
= 90
= []
= "auto"
[]
= "auto"
= false
= "size"
= 1073741824
TUI Keybindings
| Key | Action |
|---|---|
j / Down |
Move down |
k / Up |
Move up |
Enter / l / Right |
Expand/enter directory |
h / Left / Backspace |
Collapse/go up |
d / Delete |
Delete selected |
c |
Clean project |
/ |
Search |
s |
Cycle sort order |
. |
Toggle hidden files |
r |
Rescan |
? |
Help |
Esc |
Cancel active work, otherwise quit |
q |
Quit |
Cleanup Support
The TUI can identify and clean common local build artifacts for Cargo, npm, Python, CMake, Gradle, Maven, and .NET projects. Docker system resources are also surfaced when available.
Systemd Service
To run the monitor as a systemd user service:
# Install the service
# Enable and start
# Check status
# View logs
License
MIT