Sitemap
Every page of the macleanup documentation, grouped in the order of the sidebar.
- sitemap.xml — the same pages as a file search engines read.
- feed.xml — an RSS feed of macleanup releases; the readable list is the release feed.
- llms.txt — a plain-text index of these docs for AI assistants.
31 pages. macleanup is a safe-by-default macOS cleanup CLI that reclaims disk space from caches, logs, stale build artefacts and unused apps — with per-section confirmation and a real dry-run. macleanup deletes files. Read these three pages first: what it removes, how to preview a run without deleting anything, and the guarantees the safety model does and does not give you. A section-by-section inventory of macleanup deletion methods, recovery paths, and limits. How to see exactly which files macleanup would delete, without deleting anything — the flag to use first on every new machine, section and script. The six design rules that keep macleanup from deleting more than you intended — the two-condition rule, the deep-section gate, sudo handling, and where the guarantees stop. Install macleanup — or run it with no install at all — and walk through a first session end to end. Three ways to run macleanup on macOS — zero-install with npx, a global npm install, or a direct git checkout that needs no Node at all. A step-by-step first session with macleanup — preview, read the report, run one section, then widen. Nothing is deleted before you choose to run a cleanup. macleanup 5.0.0 uses one name everywhere. What changed for the command, data folder, config file and environment variables, and what the first 5.x run does for you. Every flag, every section, every profile, the config file, where logs and reports are written, and the JSON event stream. Every macleanup command-line flag — selection, confirmation, thresholds, output, persistence and informational commands — with defaults, examples and exit codes. Every macleanup section from 0 to 27 — what it removes, whether it needs sudo, whether it is reversible, and which flags tune it. The five named macleanup section bundles — dev, minimal, cache-only, deep and audit — what each one runs, when to use it, and which of them can delete permanently. Set macleanup defaults once in ~/.macleanuprc, point logs and reports elsewhere with environment variables, and understand the precedence order between them. Where macleanup writes its dated session logs and per-section report files, what each one contains, and how to move, skip or prune them. The macleanup --json-events schema, version 1 — the newline-delimited JSON events a run writes to stdout, their fields, ordering guarantees and exit codes. The macleanup desktop app runs the same script in a window: installing it, what the plans include, what stays on your Mac, and the keyboard shortcuts. What the macleanup desktop app adds to the command line — the same script underneath, a disk gauge, a dry-run ledger with keep, archive or delete, run receipts, apps and leftovers, and both launchd domains. Install the macleanup desktop app on macOS 11 or later — one disk image for Apple silicon and Intel, the one-time Gatekeeper Open Anyway step, optional Full Disk Access, and in-app updates. What the macleanup desktop app's Free, Pro and Team plans include — unlimited previews on every plan, 15 real runs a month per Mac plus 15 signed in, and Pro and Team prices as of 2026-10-30. What the macleanup desktop app keeps on your Mac and what it syncs — no telemetry, file paths never leave the Mac, and a signed-in sync of section ids, byte counts, statuses and the macOS version only. The macleanup desktop app's default keyboard shortcuts — ⌘K command palette, ⌘N new preview, ⌘Y history, ⌘, settings — and the rule that every shortcut is rebindable. Symptom-to-fix troubleshooting, and how to restore developer tooling removed by the v4.3.0 section 23 bug. Symptom, cause and fix for the problems people actually hit with macleanup — install failures, sections that find nothing, permission prompts and slow scans. What to do when a cleanup removed something you needed — including the exact commands to restore global developer tooling broken by the v4.3.0 section 23 bug. How to reach the macleanup team — get in touch, report an issue, contribute, or report a security problem privately. Copy-paste macleanup commands organised by goal — reclaim developer space, audit before deciding, uninstall an app properly, automate a weekly sweep. Straight answers about macleanup — whether it is safe, what it can break, why it ships as one bash file, whether it collects telemetry, and what it deliberately will not do. What changed in each macleanup release — the safety fixes, the two-condition rule, age-aware cache pruning, and the sections added along the way. The macleanup documentation home page. Every macleanup release, newest first, with an RSS feed.Start here
Before you run
Getting started
Reference
Desktop app
When something goes wrong
About
Recipes, FAQ and releases
Site