mcmuellermilch/ordr

ordr is a command line tool for macOS and Linux that automatically organizes messy folders like your Desktop or Downloads. You write simple rules describing where certain kinds of files should go, based on things like their extension, name pattern, size, or age, and ordr moves matching files into the right place for you. Before anything actually moves, ordr shows a preview of exactly what would happen, so you can check it looks right. Once you approve a cleanup, every action is logged, which means you can undo the entire operation with a single command if something goes wrong. There is also a background watch mode for macOS that keeps an eye on chosen folders in real time and moves new files the instant they appear, so you never have to run the tool manually. Rules live in a plain text configuration file called .ordrrc, written in YAML. A rule can match files by extension, by a name pattern like screenshots that start with a certain word, by minimum file size, or by how old the file is. Each rule points to a target folder the matching files should be moved into. The project is written in Go and organized so the core rule matching logic has no dependencies on the file system or outside tools, keeping it simple to test on its own. Installation on macOS is done through Homebrew. Building from source requires Go 1.22 or newer, and the project includes its own test scripts as well as a documentation website built with Astro Starlight. Commands cover the basics you would expect: cleaning a directory, previewing changes, undoing the last cleanup, listing and editing rules, checking status, and installing or managing the background watch agent on macOS. The project is released under the MIT license.