--sameSame logic.
The app calls the embedded tool and reads its output. Whatever you click, you can type – and script.
MacPackMate / CLI
Terminal / CLI
The command-line tool macpackmate is the actual logic of MacPackMate – the app is the interface on top and launches exactly this tool. Same data, same logic: for developers, admins and anything you can automate.
01
--sameThe app calls the embedded tool and reads its output. Whatever you click, you can type – and script.
--langLanguage follows MACPACKMATE_LANG=en|de. Coloured in the style of Claude Code: warm orange, ⏺ steps, an animated status line. NO_COLOR and FORCE_COLOR are respected.
--json--json gives machine-readable output; long commands then stream NDJSON events. Every output has a JSON Schema (2020-12).
guidemacpackmate guide shows the whole manual in your terminal – the same as ⌘? in the app.
02
The tool lives inside the app. One symlink brings it into your PATH:
❯ mkdir -p ~/.local/bin ❯ ln -sf /Applications/MacPackMate.app/Contents/Helpers/macpackmate ~/.local/bin/macpackmate
If ~/.local/bin is not on your PATH yet, add this line to ~/.zshrc:
❯ export PATH="$HOME/.local/bin:$PATH"
03
An overview taken from macpackmate --help. macpackmate help <command> shows the details of each one.
scanlist every package in parallel (default command)infoevery detail of a packagesearchsearch all package managersmanagerswhich managers are installed – install missing onesversionsall versions of a packagechangesrelease notes before you updateinstallinstall, optionally a specific versionupdateone by one or --alluninstallafter checking what depends on itreinstall · rollbackreinstall · back to the previous versionpin · unpin · pinsfreeze a versionlink · unlinkput a Homebrew formula on the PATH (node@22)migrate · adopt · adoptablepip → pipx/uv · apps → casksreason · extras · variants · tapinstall reason, extra packages, variants, tapscleanupclean up, with a dry rununusedprobably unuseddependentswho depends on whomconflictsPATH conflicts, duplicates, fixesdoctor · remedycheck health and fix itupdate-managersupdate the managers themselvesresumecontinue after a power failureauditvulnerabilities (OSV.dev), --fail-on for CIcheckupdates and vulnerabilities, what’s new since the last checkbackgrounddaily check as a LaunchAgentexportwrite a pack file or Brewfileimportrestore a pack file or Brewfile, --exact-versions, --install-managers, --dry-runservicesHomebrew background servicesautostartLaunchAgents and LaunchDaemons: view, switch on/off, remove, lognote · noteswhy is this installed?profilegroup packageshistoryevery action with versions and logguidethe whole manual in the terminallicensetrial and licence04
All examples are real commands – --dry-run shows what would happen first.
❯ macpackmate scan --outdated-only ❯ macpackmate search ripgrep ❯ macpackmate update --all --dry-run ❯ macpackmate audit --fail-on high ❯ macpackmate export -o MacPackMate.json ❯ macpackmate import MacPackMate.json --dry-run ❯ macpackmate export --format brewfile -o Brewfile ❯ macpackmate autostart list ❯ macpackmate guide
This is what macpackmate guide prints in version 0.47.0 (terminal without colours, verbatim).
❯ macpackmate guide MacPackMate Handbook TOPIC TITLE getting-started Getting Started app Using the App install Search & Install versions Versions, Rollback & Reinstall release-notes What’s New Before Updating background Background Check & Menu Bar adopt Take Over security Security Check services Services autostart Launch Items conflicts Conflicts & PATH doctor Health Check history History library Notes & Profiles edits More Changes updating Updating & Pinning uninstalling Uninstalling & Dependencies cleanup Cleaning Up unused Probably Unused backup Backup & Restore privileges Administrator Rights & Security managers Package Managers in Detail runtimes Language Versions, SDKs & Docker cli Command-Line Reference automation JSON & Automation troubleshooting Troubleshooting license Trial & Licence about About MacPackMate disclaimer Disclaimer Show a topic: macpackmate guide <topic>
05
Stable exit codes, JSON Schemas and no stored passwords make the tool fit for cron, CI and dotfiles.
scan, managers, info and others print a document with --json. Long-running commands such as update, install or import print one event per line in JSON mode; the last line is always the result.
❯ macpackmate scan --json --skip-outdated | jq '.packages[] | select(.isOutdated) | .id' ❯ macpackmate update --all --json | jq -c 'select(.type == "result") | .summary'
0 | ok |
|---|---|
1 | error |
3 | blocked (dependents or confirmation) |
4 | password prompt cancelled |
5 | vulnerability found (audit --fail-on) |
6 | trial over, licence needed |
64 | wrong usage |
MACPACKMATE_LANG | en or de – language of all output |
|---|---|
MACPACKMATE_AUTH | terminal – ask for administrator rights via sudo in the terminal |
MACPACKMATE_NO_HISTORY | 1 – do not record actions in the history |
GITHUB_TOKEN | higher request limit for GitHub release notes |
NO_COLOR · FORCE_COLOR | colours off – or on even when output is piped |
--dry-run shows the plan as a dry run.update --all skips pinned packages.sudo in the terminal, the native admin dialog in the app.The tool is part of MacPackMate: a 14-day trial with everything, then read-only mode. Scanning, searching, viewing and dry runs keep working; installing, updating and removing need a licence (exit code 6). €34 via Polar.
Manual: command-line reference (macpackmate guide cli) · ← Back to the home page