Die lokale App (Setup-App)

Die Setup-App ist die Desktop-Begleiter-App der Plattform für macOS, Windows und Linux. Du bekommst sie auf der Download-Seite.

Anmelden

Nach dem Start meldest du dich mit deinem Application-Platform-Account an. Die App lädt dann deine Organisationen und Projekte.

Die drei Bereiche

Projekte

Projekt auswählen und klonen: Alle Repositories des Projekts werden in deinen Workspace-Ordner geklont (Standard: ~/Documents/application-platform) bzw. aktualisiert.
Dabei richtet die App alles Weitere automatisch ein: ap-CLI, Git-Pre-Commit-Hook, Symlinks für die gemeinsame IDE-/KI-Konfiguration aus local-configuration und die Plattform-Extension für VS Code, Cursor und Antigravity.
Projekt in deinem Werkzeug öffnen: per Klick in der IDE oder dem KI-Tool deiner Wahl. Das Standard-Tool stellst du in den Einstellungen um – siehe Wähle dein Programm.

Entwickler-Setup

Prüft deinen Rechner und installiert fehlende Werkzeuge – von Git über Laufzeiten (Node, Flutter, Java, …) bis zu IDEs und KI-Tools. Die vollständige Liste steht unter Voraussetzungen. Jeder Eintrag zeigt seinen Status; du kannst Werkzeuge einzeln oder gesammelt installieren.

Einstellungen

Standard-Tool zum Öffnen von Projekten wählen (z. B. VS Code).
Git-Identität (Name, E-Mail) und Zugangsdaten konfigurieren.
Workspace-Ordner öffnen, Pfad kopieren, Versionen von App, CLI und Extension prüfen.

Achtung

Lege deinen Workspace-Ordner auf dem Mac nicht in einen iCloud-synchronisierten Ordner – die App warnt davor, weil die Synchronisierung Git-Repositories und Symlinks stören kann.

Updates

Die App prüft selbst auf neue Versionen und bietet dir den Download an. Auch die ap-CLI hält sich aktuell (ap cli-update check).

CLI: `ap-app` vs `ap`

Neben der GUI gibt es die Setup-CLI ap-app (Dart, gemeinsamer Core mit der Desktop-App). Damit kannst du dieselben Setup-Schritte headless steuern – z. B. für Tests oder Automatisierung:

ap-app tools status
ap-app tools install asdf-plugin-hugo
ap-app tools uninstall asdf-plugin-hugo
ap-app auth login
ap-app projects clone <org>/<project>
ap-app remote-dev status

CLI	Zweck
`ap-app`	Setup: Tools, Login-Session der Platform App, Projekt-Clone, Remote-Dev-Agent
`ap`	Laufzeit: `ap run-local`, Devices, Git-Hooks, Platform-API, MCP

Die Auth-Session teilen sich GUI und ap-app über denselben Datei-Store (~/Library/Application Support/application-platform/ap-app/session.json auf macOS, sonst ~/.config/application-platform/ap-app/session.json). Die Go-CLI ap login nutzt weiterhin einen eigenen Credential-Store.