Moving from mac-cleanup-py

This is the closest neighbour on the list: a command-line cleaner you can read. The move is mostly vocabulary. Named modules become numbered sections, and --only is how you pick them.

What maps to what

In mac-cleanup-py	In macleanup
pip3 install or brew install	npx macleanup, or a git checkout with no Node
Clear cache	Sections 3 and 5
Delete logs	Section 7
A module per tool	--only with section numbers
A saved set of modules	Profiles and ~/.macleanuprc

Sections 12 (orphaned app data) and 21 (unused apps) are the additions. Neither is in --all.

Move across

1. Run it from a checkout with bash alone.

   git clone https://github.com/aoneahsan/macleanup.git
   cd macleanup
   chmod +x macleanup.sh
   ./macleanup.sh --list

2. Preview the sections that replace your module list.

   ./macleanup.sh --only "3,5,7" --dry-run

3. Scripting it? The event stream is NDJSON. --json-events has a stated schema.

   ./macleanup.sh --only "3,5,7" --dry-run --json-events

The facts, dated

Last checked 7 November 2026. Check mac-cleanup-py yourself

mac-cleanup-py plan	Price	Source
Open sourceApache License 2.0	$0	Source7 November 2026

macleanup's own prices are on Plans and allowance.

What	mac-cleanup-py	macleanup
Clears caches	YesSource	YesSections 3, 5 and 19.
Clears logs	YesSource	YesSection 7.
Finds orphan files from removed apps	Not stated on the pages we checked	YesSection 12.
Uninstalls apps	Not stated on the pages we checked	YesSection 21, moved to the Trash.
Disk usage map	Not stated on the pages we checked	PartialA text report from section 26. No visual map.
Free to use	YesSource	YesThe command line has no limit. The app has a Free plan with a monthly run limit.
Mac App Store or notarised	Not stated on the pages we checked	NoNot notarised by Apple and not on the Mac App Store.
Open source	YesSource	PartialThe command line is MIT and public. The desktop app source is private.