> The msc command runs MacZentra from the terminal. Scan paths, find duplicates, check developer junk and preview deletions without opening the app.

[← All guides](https://maczentra.com/blog)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

Command | What 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 insights` | Full 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 monitor` | Live CPU, memory, network, battery, top processes and battery/disk health. |
`msc snapshots` | List 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 theremsc dev-junk --dry-run# Then clean it (to the Trash)msc dev-junk --apply
```

### Find duplicates and large files

Terminal

```
msc duplicatesmsc large-files --threshold 100msc 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](https://maczentra.com/blog/developer-mode-feature) 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](https://maczentra.com/guides/cli.webp)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](https://maczentra.com/blog/find-large-files-on-mac), 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 →](https://maczentra.com/features)

## Related guides

[Check storage · 5 minMacZentra App Store vs Web Version: Differences and PricingHow the App Store edition (free, $19.99/year) differs from the $49.99 lifetime web version: features, limits, why the prices differ, and which to pick.](https://maczentra.com/blog/maczentra-app-store-vs-web-version)[![Cover image for Mac App Store Sandbox: What a Cleaner Can and Can't Do](https://maczentra.com/thumbs/appstore-sunburst.webp)Check storage · 4 minMac App Store Sandbox: What a Cleaner Can and Can't DoWhy a Mac App Store storage cleaner can't scan your whole disk, what the App Sandbox blocks, and what still works in the MacZentra App Store edition today.](https://maczentra.com/blog/mac-app-store-sandbox-what-changes)[Check storage · 7 minWhy Is My Mac Running Slow? 9 CausesWhy is my Mac running slow? Nine causes, from a full disk to heat, each with a built-in way to confirm it in Activity Monitor and a free fix.](https://maczentra.com/blog/why-is-my-mac-running-slow)[![Cover image for Free Up Space on Mac: 10 Fixes, Biggest First](https://maczentra.com/thumbs/insights.webp)Free up space · 8 minFree Up Space on Mac: 10 Fixes, Biggest FirstTen ways to free up Mac storage ranked by typical space recovered. Covers hidden Library folders and leftovers macOS Storage settings never show.](https://maczentra.com/blog/free-up-space-on-mac)

Source: https://maczentra.com/blog/cli-commands-reference
