Die MainPath Toolbox ist die Desktop-Anwendung von MainPath für macOS, Windows und Linux (Downloads-Seite) und installiert die ap-CLI mit. Nach der Anmeldung mit deinem MainPath-Account zeigt sie die Bereiche Projekte, Entwickler-Setup und Einstellungen.
Entwickler-Setup
Das Entwickler-Setup prüft deinen Rechner und installiert fehlende Werkzeuge einzeln oder alle auf einmal, von Git und den Laufzeiten aus .tool-versions bis zu Editoren und KI-Werkzeugen (Voraussetzungen); führe es aus, bevor du das erste Projekt klonst.
Projekte klonen
Im Bereich Projekte klonst du ein Projekt; die App klont alle Repositories in den Workspace-Ordner, standardmäßig ~/Documents/MainPath, oder aktualisiert sie dort. Dabei richtet sie die ap-CLI, einen Pre-Commit-Hook zum Schutz von .gitlab-ci.yml und env/*.generated.env, die Symlinks auf local-configuration und MainPath-Erweiterung für VS Code, Cursor und Antigravity ein (Lokal am Projekt arbeiten).
Projekte im Editor öffnen
Aus dem Bereich Projekte öffnest du ein Projekt per Klick im Standard-Tool aus den Einstellungen; die unterstützten Editoren und Agenten stehen unter Programm wählen.
Einstellungen
In den Einstellungen wählst du das Standard-Tool, hinterlegst Git-Identität (Name, E-Mail-Adresse) und Git-Zugangsdaten, öffnest den Workspace-Ordner oder kopierst seinen Pfad und siehst die Versionen von App, CLI und Erweiterung.
Updates
Die MainPath Toolbox prüft selbst auf neue Versionen; mp cli-update check prüft die CLI, mp --version zeigt ihre Version. Ohne MainPath Toolbox installierst du die CLI mit einem Befehl, wie unter CLI und Agent-Plugin beschrieben.
Die mp CLI
mp run-local startet im Root eines Repositorys die Anwendung samt Diensten (Anwendungen starten); mp ports zeigt die lokalen Ports, mp doctor prüft die Werkzeuge, mp workspace info gibt eine Übersicht über Projekt und Repositories. Nach mp login klonst du Projekte auch ohne die Desktop-App:
mp login
mp platform projects clone <projekt-slug>
mp git auto-commit staged, committet und pusht in einem Schritt, mp secrets edit <datei> öffnet eine verschlüsselte Deployment-Konfiguration; Anmeldung, Agent-Plugin und MCP-Server stehen unter CLI und Agent-Plugin.
Die Setup-CLI ap-app
Die Setup-CLI ap-app führt dieselben Einrichtungsschritte ohne Oberfläche aus, etwa für Automatisierung:
ap-app tools status
ap-app tools install asdf-plugin-hugo
ap-app auth login
ap-app projects clone <org>/<projekt>
ap-app remote-dev status
ap-app übernimmt Werkzeuge, Anmeldesitzung der MainPath Toolbox, Klonen und Remote-Dev-Agent, ap Anwendungen, Git-Hooks, Plattform-API und MCP. MainPath Toolbox und ap-app teilen ihre Sitzung (macOS ~/Library/Application Support/application-platform/ap-app/session.json, sonst ~/.config/application-platform/ap-app/session.json), die ap-CLI meldet sich getrennt über mp login an.