Markdown

Quickstart

Quickstart

Four steps onto MainPath: install the mp CLI, add the agent plugin, import or create a project, run and publish.

On this page

MainPath creates repositories, pipelines, and deployments for your project. You need the mp CLI and, if you work with Claude Code, Cursor, or Codex, the agent plugin.

Prompt for your agent

First check whether your terminal has access to my computer or only to a cloud environment. If you are running in the cloud, confirm with me where the project should run. Starting it there does not start it locally on my computer. Without terminal access, give me the next concrete step for a local coding agent. Check the MainPath CLI with mp --version and authentication with mp whoami. In Windows PowerShell the command is mainpath instead of mp. If the CLI is missing, install it on macOS or Linux with curl -fsSL https://www.mainpath.ai/install.sh | sh, or on Windows with irm https://www.mainpath.ai/install.ps1 | iex. Then verify the absolute CLI path and version. Sign me in with mp login if needed. If a download or permission is blocked, explain the specific cause and required action. Never claim an installation or connection succeeded without checking. If code is already present, confirm its folder and import it using the available MainPath tools or mp platform projects import-local. Otherwise ask about my app idea and create it through MainPath following the guide below. Use skills only if they are actually installed. After successful setup, start with mp run-local and report the verified address and actual execution environment.

Prerequisites

1. Install the mp CLI and sign in

macOS and Linux:

curl -fsSL https://www.mainpath.ai/install.sh | sh

Windows (PowerShell):

irm https://www.mainpath.ai/install.ps1 | iex

The script puts the CLI on your PATH. On Windows the command is mainpath, on macOS and Linux it is mp. Open a new terminal afterwards and sign in:

mp login

Windows (PowerShell):

mainpath login

If you want your whole computer set up (runtimes, editors, projects), use the MainPath Toolbox instead; it includes the CLI.

2. Install the agent plugin

mp agent install

The CLI places skills, rules, and the MCP server with Cursor, Claude Code, and Codex and writes the absolute path to mp into the user MCP file. mp login and mp doctor run the same step. Reload your editor afterwards. All installation paths are listed under CLI and agent plugin.

3. Import or create a project

Existing folder: Tell the agent “Import this project into my MainPath account.” or use the CLI in the project folder:

mp platform projects import-local . "My project"

Supported stacks are Flutter, React Native (Expo), Next.js, native iOS and Android, Hugo, Astro, NestJS, FastAPI, and Laravel. Details: Import an existing repository.

New project: Tell the agent “Create a new project with a Next.js app and a NestJS backend and clone it.” or use the CLI:

mp platform projects demo-json --minimal -o project.json
mp platform projects create --from-json project.json --watch
mp platform projects clone <project-slug>

Without the CLI, use the wizard under Projects in the web interface. Details: Create a new project.

Either way, the project ends up under ~/Documents/MainPath/<organization>/<project>/ with one folder per repository.

4. Run and publish

cd ~/Documents/MainPath/<organization>/<project>/<repository>
mp run-local

A push to main starts the pipeline and deploys to dev; you release production in GitLab with one click. For that, the project needs a server and, for its own address, a domain. Git workflow and deployment describes the flow.

Further reading

Thank you for your request

We have received your request and will get back to you as soon as possible.

Would you like to talk to us directly?

Choose a time here for an introductory call with Robin.

Open the calendar in a new tab