Der Import legt aus einem lokalen Ordner ein Projekt an, klont die generierten Repositories, legt deine Dateien darüber und pusht auf main; er braucht ap login (CLI und Agent-Plugin).
Per CLI
ap platform projects import-local ~/code/shop "Shop"
Der Befehl nimmt Pfad und Projektname (alternativ --name), klont nach ~/Documents/application-platform/<organisations-slug>/<projekt-slug>/, überträgt die Dateien ohne .git, .gitlab-ci.yml und env/*.generated.env anzutasten und committet und pusht jedes Repository.
--slug, --description und --workspace-root setzen Slug, Beschreibung und Workspace-Ordner, --flat-layout das Layout <workspace-root>/<projekt-slug> ohne Organisationsebene, --skip-commit lässt Commit und Push aus; mehrere Komponenten ordnest du mit --repositories-json Unterordnern zu:
ap platform projects import-local ~/code/shop "Shop" \
--repositories-json '[{"path":"homepage","name":"Marketing"},{"path":"api","name":"API"}]'
Unterstützte Stacks
Der Import erkennt nur Stacks des Assistenten; die Bezeichner gelten für techStack in --repositories-json und den MCP-Werkzeugen.
| Typ | Bezeichner |
|---|---|
| App | flutter, react-native-expo, nextjs, native-ios, native-android |
| Homepage | hugo, astro |
| Backend | nestjs, fastapi, laravel |
| Package (nur bei eindeutigem Package-Ordner) | dart-package, docker-image, npm, go, kotlin, pypi, terraform-module, terraform-provider, vscode-plugin |
Django, Vue, Express, Symfony, Svelte, Spring und andere Frameworks fehlen heute im Assistenten; der Agent bricht dann ab und nennt das fehlende Framework.
Per Agent
Mit installiertem Agent-Plugin öffnest du den Ordner in Cursor, Claude Code oder Codex und fügst diesen Prompt ein; Bestehendes Projekt übernehmen führt vom Account bis hierher.
Du holst ein bestehendes lokales Projekt in die Application Platform.
Voraussetzungen – sonst sofort abbrechen und sagen, was fehlt:
- Application-Platform-Account
- MCP-Server "application-platform" verbunden (über die ap CLI angemeldet)
Nur diese Stacks sind erlaubt:
- App: Flutter, React Native (Expo), Next.js, natives iOS, natives Android
- Homepage: Hugo, Astro
- Backend: NestJS, FastAPI, Laravel
- Package nur wenn eindeutig: Dart-Package, Docker-Image, NPM, Go, PyPI, Terraform-Modul/-Provider, VS-Code-Plugin
Steht ein Framework nicht in der Liste (Django, Vue, Express, Symfony, Svelte, Spring, …): STOPP.
Sage klar: "[Name] ist heute nicht im Assistenten (auch wenn es auf der Roadmap steht)."
Keine ähnlichen Stacks vorschlagen, nichts umbiegen.
Nutze das MCP-Werkzeug platform_projects_import_local mit dem Pfad dieses Ordners und einem Projektnamen. Es legt das Projekt an, wartet bis das Setup fertig ist, klont die Repositories in den Workspace, übernimmt die lokalen Dateien und pusht auf main.
Fehlt das Werkzeug: platform_projects_demo_json, platform_projects_create, platform_watch, platform_projects_clone, danach die Dateien übernehmen und pushen.
Wenn Anlegen, Import oder Warten fehlschlägt, melde den Fehler. Kein eigenes git clone oder git remote add als Ausweg.
Generierte CI- und Umgebungsdateien nicht überschreiben. Eigene Werte in die custom-Umgebungsdateien.
Keine Secrets committen.
Der Skill import-existing-project prüft ap, die Anmeldung (platform_whoami) und den MCP-Server application-platform, bestätigt Pfad und Projektnamen und ruft platform_projects_import_local mit path und name auf, optional mit slug, description, workspaceRoot und repositories[] (path, name, repositoryName, type, techStack). Ältere Clients ohne dieses Werkzeug nutzen platform_projects_create, platform_watch (Subjekt project) und platform_projects_clone, übernehmen die Dateien ohne .git, .gitlab-ci.yml und env/*.generated.env und pushen auf main.
Schlägt Create, Import oder Watch fehl, ist das die Antwort; der Agent klont nicht von Hand, erfindet keine zweite API und schreibt keine Secrets in Commits oder Antworten.
Danach im Workspace arbeiten
Ab jetzt arbeitest du im geklonten Workspace statt im alten Ordner; dort gelten AGENTS.md und CLAUDE.md aus local-configuration, und jede Anwendung startet mit ap run-local (Lokal entwickeln). Der erste Push hat die Pipelines gestartet (Git-Workflow und Deployment).