Die Setup-App ist die Desktop-Anwendung der Plattform für macOS, Windows und Linux (Downloads-Seite) und installiert die ap-CLI mit. Nach der Anmeldung mit deinem Application-Platform-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/application-platform, 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 die Plattform-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 Setup-App prüft selbst auf neue Versionen; ap cli-update check prüft die CLI, ap --version zeigt ihre Version. Ohne Setup-App installierst du die CLI mit einem Befehl, wie unter CLI und Agent-Plugin beschrieben.
Die ap CLI
ap run-local startet im Root eines Repositorys die Anwendung samt Diensten (Anwendungen starten); ap ports zeigt die lokalen Ports, ap doctor prüft die Werkzeuge, ap workspace info gibt eine Übersicht über Projekt und Repositories. Nach ap login klonst du Projekte auch ohne die Desktop-App:
ap login
ap platform projects clone <projekt-slug>
ap git auto-commit staged, committet und pusht in einem Schritt, ap 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 Setup-App, Klonen und Remote-Dev-Agent, ap Anwendungen, Git-Hooks, Plattform-API und MCP. Setup-App 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 ap login an.