# Bestehendes Projekt übernehmen

Ein Ordner, den du mit Claude Code, Cursor oder Codex gebaut hast, kommt mit einem Prompt auf die Application Platform, sofern sein Tech-Stack unterstützt wird.

> Source: https://www.application-platform.com/de/docs/import-existing-project/

Eine mit einem KI-Agenten gebaute Anwendung bringt derselbe Agent auf die Plattform; ein Hochladen im Browser gibt es nicht.

## Was du brauchst

- Einen Account unter [app.application-platform.com/register](https://app.application-platform.com/register) mit einer Organisation, siehe [Dein erstes Projekt anlegen]({{< relref "getting-started" >}}).
- Die ap CLI. Im Terminal installierst du sie mit `curl -fsSL https://www.application-platform.com/install.sh | sh` (Windows in PowerShell: `irm https://www.application-platform.com/install.ps1 | iex`); die [Setup-App]({{< relref "/downloads" >}}) bringt sie ebenfalls mit.
- Node.js ab Version 18, prüfbar mit `node --version`; fehlt es, installiert es das **Entwickler-Setup** der Setup-App.
- Claude Code, Cursor oder Codex.
- Einen unterstützten Tech-Stack, siehe unten.

## Ein Terminal öffnen

Die nächsten Befehle gibst du in ein Terminal ein, in Cursor und VS Code über **Terminal** → **Neues Terminal**.

## Agent-Plugin installieren und anmelden

```bash
npx --yes github:doppelt-digital/application-platform-plugin
```

Der Installer erkennt die installierten Agenten, legt bei ihnen Skills und MCP-Konfiguration ab und öffnet den Browser für die Anmeldung; danach zeigt `ap whoami` deinen Account.

Wird `ap` nicht gefunden, fehlt die ap CLI; öffnet sich kein Browser, gib `ap login` ein. Zum Schluss lädst du Cursor über „Fenster neu laden“ neu und startest Claude Code oder Codex neu.

## Den Prompt einfügen

Öffne den Projektordner im Agenten, in Cursor über **Datei** → **Ordner öffnen**, für Claude Code oder Codex per `cd` im Terminal und `claude` oder `codex`, und füge diesen Prompt ein:

{{< agent-import-prompt >}}

Kürzer geht es mit dem Slash-Command `/import-existing-project` des Plugins.

## Was der Agent tut

Der Agent bestätigt den Pfad, fragt nach dem Projektnamen und ruft `platform_projects_import_local` auf, das die Tech-Stacks erkennt, das Projekt anlegt, auf Repositories und Pipelines wartet, sie klont, deine Dateien darüberlegt und alles auf `main` pusht; `.gitlab-ci.yml` und `env/*.generated.env` bleiben erhalten.

Ab jetzt arbeitest du in `~/Documents/application-platform/<organisation>/<projekt>/` mit einem Unterordner pro Repository und `local-configuration`; der alte Ordner ist nicht mit der Plattform verbunden.

Meldet der Agent, dass du nicht angemeldet bist oder der MCP-Server fehlt, hilft [Wenn etwas nicht klappt]({{< relref "get-help" >}}).

## Wenn dein Stack nicht unterstützt wird

Unterstützt werden Apps mit Flutter, React Native (Expo), Next.js, nativem iOS und nativem Android, Homepages mit Hugo und Astro, Backends mit NestJS, FastAPI und Laravel sowie eindeutige Packages wie npm-Paket, Dart-Package oder Docker-Image.

Bei anderen Frameworks bricht der Agent ab und legt kein Projekt mit einem anderen Stack an; einen fehlenden Stack meldest du über die [Feedback-Seite]({{< relref "/feedback" >}}).

Den CLI-Befehl `ap platform projects import-local` für Entwickler beschreibt [Bestehendes Repository importieren]({{< relref "agent-project-import" >}}).

Weiter geht es mit [Rechner einrichten oder im Browser arbeiten]({{< relref "setup-your-computer" >}}).