Developer Tool / Python CLI / 2026
sweepr
sweepr is a command-line developer utility written in Python. It automatically sweeps, organizes, and classifies messy folders based on custom extension structures and rules.
Visit project
The project.
sweepr is a lightweight developer automation script designed to maintain system directory cleanliness without manual file classification sorting.
It compiles file extension statistics, matches custom mapping rules, and safely migrates untracked files into sorted folders in milliseconds.
Configurable Rules, Automated Cleans
Sweepr relies on a clean, descriptive JSON or command configuration map. Users can define custom folder destination mappings (e.g. all `.zip` and `.tar.gz` files into /Archives), run dry-runs, and undo actions.
Terminal-Driven
The layout of sweepr is built for terminal output. Minimal color formatting and clean logs provide a robust user experience directly inside shell scripts.
Verbose warning logs and summary counts ensure you always understand what actions the CLI has processed.
Safe Operations
Incorporates dry-run capabilities to log planned directory modifications without executing them. This ensures absolute safety before modifying system files.
Logs are formatted clearly, showing destination and source locations for every item.
Python Native
Leverages lightweight standard library dependencies, guaranteeing fast execution and easy global script installations.
Batch Processing
Handles thousands of directory entries concurrently, indexing file sizes and classifying types with fast file-handle operations.
CLI Status
Emits structured, clean standard output status reviews, simplifying scripting integration and cron scheduler automation.
