# Die Setup-App und die ap CLI Die Setup-App richtet deinen Rechner ein, klont Projekte und öffnet sie im Editor deiner Wahl, während die ap CLI im Terminal Anwendungen startet und die Verbindung zur Plattform herstellt. > Source: https://www.application-platform.com/de/docs/local-app/ Die Setup-App ist die Desktop-Anwendung der Plattform für macOS, Windows und Linux ([Downloads-Seite]({{< relref "/downloads" >}})) 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]({{< relref "local-requirements" >}})); 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]({{< relref "working-locally" >}})). {{< docnote type="warning" >}} Lege den Workspace-Ordner auf dem Mac nicht in einen von iCloud synchronisierten Ordner, weil die Synchronisierung Git-Repositories und Symlinks stören kann. {{< /docnote >}} ## 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]({{< relref "choosing-your-ide" >}}). ## 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]({{< relref "cli-and-agent-plugin" >}}) beschrieben. ## Die ap CLI `ap run-local` startet im Root eines Repositorys die Anwendung samt Diensten ([Anwendungen starten]({{< relref "workspace-ubuntu-dev-scripts" >}})); `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: ```bash ap login ap platform projects clone ``` `ap git auto-commit` staged, committet und pusht in einem Schritt, `ap secrets edit ` öffnet eine verschlüsselte Deployment-Konfiguration; Anmeldung, Agent-Plugin und MCP-Server stehen unter [CLI und Agent-Plugin]({{< relref "cli-and-agent-plugin" >}}). ## Die Setup-CLI ap-app Die Setup-CLI `ap-app` führt dieselben Einrichtungsschritte ohne Oberfläche aus, etwa für Automatisierung: ```bash ap-app tools status ap-app tools install asdf-plugin-hugo ap-app auth login ap-app projects clone / 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.