# Lokal am Projekt arbeiten

Die MainPath Toolbox richtet deinen Rechner ein und klont alle Repositories eines Projekts in einen gemeinsamen Ordner, in dem Editoren und KI-Agenten das ganze Projekt sehen.

> Source: https://www.mainpath.ai/de/docs/working-locally/

Lokal liegen Werkzeuge und Code auf deinem Rechner unter macOS, Windows oder Linux. Die [MainPath Toolbox]({{< relref "local-app" >}}) installiert fehlende Werkzeuge, klont deine Projekte und öffnet sie im Editor deiner Wahl; die Anforderungen an den Rechner stehen unter [Voraussetzungen]({{< relref "local-requirements" >}}). Ohne Installation arbeitest du in einem [Remote-Workspace]({{< relref "workspaces-overview" >}}), einer vorbereiteten Ubuntu-VM in der Cloud, auf dieselbe Weise.

## Ablauf der Einrichtung

Du lädst die MainPath Toolbox von der [Downloads-Seite]({{< relref "/downloads" >}}), meldest dich mit deinem MainPath-Account an und führst das **Entwickler-Setup** aus, das von Git über die Laufzeiten bis zur `ap`-CLI installiert, was fehlt. Danach klonst du im Bereich **Projekte** ein Projekt; die App holt alle Repositories, legt die gemeinsame Konfiguration an und öffnet das Projekt per Klick im Editor oder KI-Werkzeug.

## Der Projektordner

Alle Repositories eines Projekts liegen nebeneinander unter `~/Documents/MainPath/<organisation>/<projekt>/`: ein Verzeichnis pro Komponente, `local-configuration` für Editor-Einstellungen und `gitops-configuration` für das Deployment.

```
~/Documents/MainPath/<organisation>/<projekt>/
├── backend/                 # ein Ordner pro Repository
├── <app>/
├── homepage/
├── local-configuration/     # gemeinsame Editor-Konfiguration (.vscode, .idea)
├── gitops-configuration/    # Deployment-Konfiguration
├── .vscode → local-configuration/.vscode
└── …
```

Die Einträge auf `local-configuration` sind Symlinks, die die MainPath Toolbox beim Klonen anlegt; dadurch gelten dieselben Editor-Einstellungen für alle Repositories. Regeln für KI-Agenten kommen aus dem Agent-Plugin (`mp agent install`), eigene Projektregeln aus einer `AGENTS.md` im Anwendungs-Repository ([Eigene Regeln für KI-Agenten]({{< relref "ai-instructions" >}})). Öffne im Editor oder KI-Agenten immer diesen Projektordner und nicht ein einzelnes Repository, damit Backend, App und Homepage zusammen sichtbar sind.

## Arbeiten im Projekt

Jede Anwendung startest du im Root ihres Repositorys mit `mp run-local`, das je nach Typ Docker-Dienste und Entwicklungsserver, Flutter Web oder Hugo mit den passenden Umgebungsdateien startet; Ports, Beenden und typische Fehler beschreibt [Anwendungen starten]({{< relref "workspace-ubuntu-dev-scripts" >}}). Die Laufzeitversionen stehen pro Repository in `.tool-versions`, bereitgestellt von `asdf` auf macOS und Linux und von FVM, NVM und HVM auf Windows. Konfigurationswerte liegen in `env/*.generated.env` (Plattform) und `env/*.custom.env` (eigene Werte), siehe [Umgebungsvariablen]({{< relref "environment-setup" >}}); ein Push auf `main` startet die Pipeline aus [Git-Workflow und Deployment]({{< relref "git-workflow" >}}).