MacPackMate

MacPackMate / CLI

Terminal / CLI

Alles, was die App kann. Im Terminal.

Das Befehlszeilen-Tool macpackmate ist die eigentliche Logik von MacPackMate – die App ist die Oberfläche darüber und startet genau dieses Tool. Dieselben Daten, dieselbe Logik: für Entwickler, Admins und alles, was sich automatisieren lässt.

01

Ein Tool. Zwei Oberflächen.

--same

Dieselbe Logik.

Die App ruft das eingebettete Tool auf und liest dessen Ausgabe. Was du anklickst, kannst du tippen – und skripten.

--lang

Deutsch & Englisch.

Die Sprache folgt MACPACKMATE_LANG=en|de. Farbig im Stil von Claude Code: warmes Orange, ⏺-Schritte, animierte Statuszeile. NO_COLOR und FORCE_COLOR werden beachtet.

--json

Für Skripte.

--json gibt maschinenlesbare Ausgabe, lange Befehle senden dabei NDJSON-Events. Alle Ausgaben haben ein JSON-Schema (2020-12).

guide

Handbuch inklusive.

macpackmate guide zeigt das ganze Handbuch im Terminal – dasselbe wie in der App mit ⌘?.

02

Einrichtung in zwei Zeilen.

Das Tool steckt in der App. Ein Symlink holt es in den PATH:

macpackmate — zsh
❯ mkdir -p ~/.local/bin
❯ ln -sf /Applications/MacPackMate.app/Contents/Helpers/macpackmate ~/.local/bin/macpackmate

Ist ~/.local/bin noch nicht im PATH, trage diese Zeile in ~/.zshrc ein:

macpackmate — zsh
❯ export PATH="$HOME/.local/bin:$PATH"

03

Befehle, nach Aufgabe sortiert.

Eine Übersicht aus macpackmate --help. Die Details zu jedem Befehl zeigt macpackmate help <befehl>.

Übersicht & Suche

  • scanalle Pakete parallel auflisten (Standardbefehl)
  • infoalle Details eines Pakets
  • searchin allen Paketmanagern suchen
  • managerswelche Manager installiert sind – fehlende installieren
  • versionsalle Versionen eines Pakets
  • changesRelease Notes vor dem Update

Ändern

  • installinstallieren, auf Wunsch in einer Version
  • updateeinzeln oder --all
  • uninstallnach Prüfung der Abhängigen
  • reinstall · rollbackneu installieren · zur vorigen Version
  • pin · unpin · pinsVersion festhalten
  • link · unlinkHomebrew-Formel in den PATH (node@22)
  • migrate · adopt · adoptablepip → pipx/uv · Apps → Casks
  • reason · extras · variants · tapInstallationsgrund, Zusatzpakete, Varianten, Taps

Pflege

  • cleanupaufräumen, mit Probelauf
  • unusedvermutlich ungenutzt
  • dependentswer hängt von wem ab
  • conflictsPATH-Konflikte, Doppelte, Lösungen
  • doctor · remedyZustand prüfen und beheben
  • update-managersdie Manager selbst aktualisieren
  • resumenach Stromausfall fortsetzen

Sicherheit & Hintergrund

  • auditSicherheitslücken (OSV.dev), --fail-on für CI
  • checkUpdates und Lücken, Neues seit der letzten Prüfung
  • backgroundtägliche Prüfung als LaunchAgent

Backup & Umzug

  • exportPackdatei oder Brewfile schreiben
  • importPackdatei oder Brewfile einspielen, --exact-versions, --install-managers, --dry-run

Dienste

  • servicesHomebrew-Hintergrunddienste
  • autostartLaunchAgents und LaunchDaemons: ansehen, aus-/einschalten, entfernen, Log

Ordnung & Wissen

  • note · noteswarum ist das installiert?
  • profilePakete gruppieren
  • historyjede Aktion mit Versionen und Log
  • guidedas ganze Handbuch im Terminal
  • licenseTestzeit und Lizenz

04

Ein paar Beispiele.

Alle Beispiele sind echte Befehle – --dry-run zeigt vorher, was passieren würde.

macpackmate — zsh
❯ 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

Echte Ausgabe: das Handbuch

So sieht macpackmate guide in Version 0.47.0 aus (Terminal ohne Farben, wortgetreu).

macpackmate — zsh
❯ macpackmate guide
MacPackMate-Handbuch

THEMA             TITEL
getting-started   Erste Schritte
app               Die App benutzen
install           Suchen & Installieren
versions          Versionen, Zurücksetzen & Neu installieren
release-notes     Was ist neu – vor dem Update
background        Hintergrundprüfung & Menüleiste
adopt             Übernehmen
security          Sicherheitsprüfung
services          Dienste
autostart         Autostart
conflicts         Konflikte & PATH
doctor            Zustand prüfen
history           Verlauf
library           Notizen & Profile
edits             Weitere Änderungen
updating          Aktualisieren & Pinnen
uninstalling      Deinstallieren & Abhängigkeiten
cleanup           Aufräumen
unused            Vermutlich ungenutzt
backup            Sichern & Wiederherstellen
privileges        Administratorrechte & Sicherheit
managers          Paketmanager im Detail
runtimes          Sprachversionen, SDKs & Docker
cli               Befehlszeilen-Referenz
automation        JSON & Automatisierung
troubleshooting   Fehlerbehebung
license           Testzeit & Lizenz
about             Über MacPackMate
disclaimer        Haftungsausschluss

Thema anzeigen: macpackmate guide <thema>

05

Für Automatisierung.

Stabile Exit-Codes, JSON-Schemas und keine gespeicherten Passwörter machen das Tool tauglich für Cron, CI und Dotfiles.

JSON und Events

scan, managers, info und andere geben mit --json ein Dokument aus. Lang laufende Befehle wie update, install oder import geben im JSON-Modus ein Ereignis pro Zeile aus; die letzte Zeile ist immer das Ergebnis.

macpackmate — zsh
❯ macpackmate scan --json --skip-outdated | jq '.packages[] | select(.isOutdated) | .id'
❯ macpackmate update --all --json | jq -c 'select(.type == "result") | .summary'

Exit-Codes

0ok
1Fehler
3blockiert (Abhängige oder Bestätigung)
4Passwortabfrage abgebrochen
5Sicherheitslücke gefunden (audit --fail-on)
6Testzeit vorbei, Lizenz nötig
64falsche Verwendung

Umgebungsvariablen

MACPACKMATE_LANGen oder de – Sprache aller Ausgaben
MACPACKMATE_AUTHterminal – Administratorrechte per sudo im Terminal erfragen
MACPACKMATE_NO_HISTORY1 – Aktionen nicht im Verlauf festhalten
GITHUB_TOKENhöheres Anfragelimit bei Release Notes von GitHub
NO_COLOR · FORCE_COLORFarben aus – bzw. auch bei weitergeleiteter Ausgabe

Das Sicherheitsversprechen gilt auch hier.

  • Aktionen sind vorher sichtbar: Befehle erscheinen, bevor sie laufen.
  • --dry-run zeigt den Plan als Probelauf.
  • Vor dem Entfernen prüft MacPackMate die Abhängigkeiten.
  • Gepinnte Pakete überspringt update --all.
  • Keine gespeicherten Passwörter: sudo im Terminal, nativer Admin-Dialog in der App.
  • Die Sicherheitsprüfung läuft nur auf Befehl – es gehen nur Paketnamen und Versionen an OSV.dev.

Gehört zur App. Gleiche Lizenz.

Das Tool ist Teil von MacPackMate: 14 Tage Testzeit mit allem, danach der Lesemodus. Scannen, Suchen, Ansehen und Probeläufe gehen weiter; Installieren, Aktualisieren und Entfernen brauchen eine Lizenz (Exit-Code 6). 34 € über Polar.

Handbuch: Befehlszeilen-Referenz (macpackmate guide cli) · ← Zurück zur Startseite