j-akiru5/prism-organizer

Prism Organizer is a command-line tool for Windows that scans a folder on your computer and helps you sort, clean, and understand what is in it. You point it at a directory like your Downloads folder and it produces a report breaking down file types, the largest files, duplicates, and junk files like incomplete downloads or temporary files. The tool can reorganize files in two ways: by type (moving images, documents, videos, and code files into separate subfolders) or by date (sorting files into year and month folders). A three-phase duplicate finder checks file size first, then a partial hash, then a full SHA-256 hash to confirm exact duplicates quickly. There is also a perceptual hashing mode that finds visually similar images even if they are not byte-for-byte identical. Every operation creates a log so you can undo it, and by default the tool shows a preview of what it will do before making any changes. Beyond the basic commands, the tool offers a watch mode that monitors a folder in real time and automatically sorts or cleans new files as they arrive. A scheduling feature connects to Windows Task Scheduler so you can run organize jobs on a daily or weekly basis without opening the tool manually. If you want to define your own sorting rules, you can write them in a YAML configuration file. An AI classification feature can suggest categories for files whose names are ambiguous. It supports three providers: OpenAI (paid, cloud-based), Ollama (free, runs locally on your machine), and LM Studio (free, runs locally). An interactive setup wizard walks you through choosing and configuring a provider. Installation does not require Python if you use the npm package, which downloads a standalone binary on first run. Python users can also install it with pip or clone the repository directly. The tool runs on Windows and is released under the MIT license. The full README is longer than what was shown.