What is macsweep?

MacSweep is a terminal based storage manager for Mac computers that works entirely offline. It is built as a free, open source alternative to paid tools like CleanMyMac, Hazel, and Gemini 2, and the author is upfront that it sends no data anywhere: no cloud connection, no telemetry, and no subscription fees. The tool bundles four main jobs into one interface. A storage scanner walks through your folders to show which files and directories are taking up the most space, along with a breakdown by file type and a live disk usage bar. A duplicate finder looks for identical files using a two step process: it first groups files by size, then hashes just the first chunk of matching files, and only runs a full checksum on the files that still look identical, which keeps it fast on large drives. A smart organizer sorts files into categories like Images, Documents, Code, and Archives using rules you can edit in a configuration file, and it shows you the planned moves before anything happens. A cache and junk cleaner targets developer clutter specifically, such as Homebrew, npm, and pip caches, old Xcode build files, stray logs, and hidden .DS_Store files, and it asks for typed confirmation before deleting anything over one gigabyte. Safety is a clear focus. Core system folders like /System, /usr, /bin, and /Library are blocked from being touched at all. Deleted files are not removed permanently, they are moved to a trash folder inside the app's own data directory, and every move or delete is logged so it can be undone with a single keypress. To try it, you clone the repository, set up a Python virtual environment, install the requirements, and run the main script from a terminal. It is written in Python, has a test suite runnable with pytest, and is released under the MIT license, so it can be used and modified freely.