# Bring in an existing project

A folder you built with Claude Code, Cursor, or Codex comes onto the Application Platform with one prompt, provided its tech stack is supported.

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

An application built with an AI agent is brought onto the platform by that same agent; there is no upload in the browser.

## What you need

- An account at [app.application-platform.com/register](https://app.application-platform.com/register) with an organization, see [Create your first project]({{< relref "getting-started" >}}).
- The ap CLI. Install it from the terminal with `curl -fsSL https://www.application-platform.com/install.sh | sh` (Windows, in PowerShell: `irm https://www.application-platform.com/install.ps1 | iex`); the [setup app]({{< relref "/downloads" >}}) ships it as well.
- Node.js version 18 or newer, checked with `node --version`; if it is missing, the **Developer setup** of the setup app installs it.
- Claude Code, Cursor, or Codex.
- A supported tech stack, see below.

## Open a terminal

You type the next commands into a terminal, in Cursor and VS Code via **Terminal** → **New Terminal**.

## Install the agent plugin and sign in

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

The installer detects the installed agents, places skills and MCP configuration with them, and opens the browser for signing in; afterwards `ap whoami` shows your account.

If `ap` is not found, the ap CLI is missing; if no browser opens, type `ap login`. Finally, reload Cursor via "Reload Window" and restart Claude Code or Codex.

## Paste the prompt

Open the project folder in the agent, in Cursor via **File** → **Open Folder**, for Claude Code or Codex via `cd` in the terminal and `claude` or `codex`, and paste this prompt:

{{< agent-import-prompt >}}

The short version is the slash command `/import-existing-project` that comes with the plugin.

## What the agent does

The agent confirms the path, asks for the project name, and calls `platform_projects_import_local`, which detects the tech stacks, creates the project, waits for repositories and pipelines, clones them, lays your files over them, and pushes everything to `main`; `.gitlab-ci.yml` and `env/*.generated.env` are kept.

From now on you work in `~/Documents/application-platform/<organization>/<project>/` with one subfolder per repository plus `local-configuration`; the old folder is not connected to the platform.

If the agent reports that you are not signed in or that the MCP server is missing, [When something does not work]({{< relref "get-help" >}}) helps.

## If your stack is not supported

Supported are apps with Flutter, React Native (Expo), Next.js, native iOS, and native Android, homepages with Hugo and Astro, backends with NestJS, FastAPI, and Laravel, and unambiguous packages such as an npm package, a Dart package, or a Docker image.

For other frameworks the agent stops and does not create a project with a different stack; report a missing stack on the [feedback page]({{< relref "/feedback" >}}).

The CLI command `ap platform projects import-local` for developers is described in [Import an existing repository]({{< relref "agent-project-import" >}}).

Continue with [Set up your computer or work in the browser]({{< relref "setup-your-computer" >}}).