# Die MainPath Toolbox und die mp CLI

Die MainPath Toolbox richtet deinen Rechner ein, klont Projekte und öffnet sie im Editor deiner Wahl, während die mp CLI im Terminal Anwendungen startet und die Verbindung zu MainPath herstellt.

> Source: https://www.mainpath.ai/de/docs/local-app/

Die MainPath Toolbox ist die Desktop-Anwendung von MainPath für macOS, Windows und Linux ([Downloads-Seite]({{< relref "/downloads" >}})) 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]({{< 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/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]({{< 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 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]({{< relref "cli-and-agent-plugin" >}}) beschrieben.

## Die mp CLI

`mp run-local` startet im Root eines Repositorys die Anwendung samt Diensten ([Anwendungen starten]({{< relref "workspace-ubuntu-dev-scripts" >}})); `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:

```bash
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]({{< 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 <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.