Skip to content
← All guides

Check storage

MacZentra CLI: Command Reference and Use Cases

The MacZentra team · Updated Oct 1, 2026 · 6 min read

The msc command is MacZentra's headless companion for the terminal. It reuses the exact same backend as the desktop app, the same scanner, duplicate finder, developer-junk and large-file engines, so its results match the GUI with no drift. It's a Pro feature: every run checks your license first, and every deletion goes to the Trash so it stays recoverable.

Installing the command

Install msc from the app's Settings panel. It symlinks the bundled binary to /usr/local/bin/msc, or falls back to ~/.local/bin/msc if /usr/local/bin isn't writable. If the app is running from a translocated (quarantined) path, typically straight out of ~/Downloads, the symlink would break on restart, so move MacZentra.app to /Applications first.

Command reference

CommandWhat it does
msc scan [--path <dir>]Fast parallel disk-usage sweep of a directory.
msc duplicates [--path <dir>]Find exact-duplicate files under a directory.
msc dev-junk [--dry-run] [--apply]Scan, and optionally clean, developer junk (Docker, Xcode, node_modules, Python).
msc large-files [--path <dir>] [--threshold <MB>] [--age <days>] [--apply]Find, and optionally delete, large or old files.
msc delete <path>...Move one or more paths to the Trash (recoverable).
msc diff [--dry-run]Print the Git-style deletion preview to stdout.
msc insightsFull storage analysis: duplicates, stale files, caches, logs and large files.
msc junk [--dry-run] [--apply]Scan, and optionally clean, user caches, logs and old installers.
msc monitorLive CPU, memory, network, battery, top processes and battery/disk health.
msc snapshotsList local APFS snapshots (Time Machine vs system-managed).
msc schedule [show | set <daily|weekly|monthly> <HH:MM> [--type smart-care|junk|both] | off]Show, set or turn off the scheduled background cleanup.
msc protect [list | add <dir> | remove <dir>]Manage folders every scan and cleanup skips.
msc license [status]Show whether a Pro license is active on this Mac.

Output is ANSI color-coded with human-readable sizes (KB/MB/GB) and compact tables. Colors auto-disable when output isn't a terminal (piped or redirected) or when NO_COLOR is set, so logs stay clean.

Common use cases

Sweep a specific folder

Terminal
msc scan --path ~/Desktop

Preview developer junk before touching anything

--dry-run reports what it found and reclaimable sizes without deleting. Add --apply only when you're ready.

Terminal
# See what's there
msc dev-junk --dry-run
# Then clean it (to the Trash)
msc dev-junk --apply

Find duplicates and large files

Terminal
msc duplicates
msc large-files --threshold 100
msc large-files --path ~/Movies --threshold 500 --age 180

The last example lists files over 500 MB that haven't changed in 180 days under ~/Movies. Add --apply to move the matches to the Trash.

Audit a deletion as a diff

msc diff prints the same Git-style unified-diff preview the GUI's Developer Mode shows, so you can review exactly what a cleanup would remove, pipe it to a file, or keep it with your change log.

Terminal
msc diff --dry-run > cleanup-preview.patch
MacZentra Developer tab in Settings screen
Install the msc command from Settings → Developer, with example commands shown.

Does the CLI need a license?

Yes. msc is a Pro power-user tool. Each invocation verifies the same offline, machine-bound license the GUI uses; with no valid license it prints an "Upgrade Required" notice and exits non-zero. Scanning in the app itself is always free, see finding large files, but the headless tooling is part of the paid version.

Everything MacZentra can clean

Treemap and Sunburst disk maps, a duplicate finder, Developer Junk, a complete app uninstaller and more, in one native storage cleaner for Mac that’s 15.4 MB.

Explore all features →