Import CLI projects to the Astro IDE | Astronomer Documentation

Public Preview

This feature is in Public Preview.

Import an existing project into the Astro IDE by uploading a local CLI project.

Connect a CLI project

Prerequisites

A local Astro project directory that you want to import.
The Astro CLI installed and authenticated locally.
Workspace Author permissions.

Open Astro IDE

From the Astro UI main menu, select Astro IDE.

Open the Projects tab

Click Projects to open the Projects tab.

Click ”+ Add Project”

Click + Add Project, then select Import CLI Project from the dropdown menu.

Run the export command in your terminal

Copy the command from the dialog and run it in your terminal from the root of your existing Astro CLI project directory. This command uploads your local project files to the Astro IDE:

$ astro ide project export

Refresh to complete import

Return to the Astro IDE and refresh the page to see your imported project.

Start a new session with your imported project

After importing your project, you can start a new session with it.

Prerequisites

You need to have an imported project in the Astro IDE. Follow the steps in Connect a CLI project to import a CLI project if you haven’t already.

Open the Astro IDE

From the Astro UI main menu, select Astro IDE.

Open the Projects tab

Click Projects to open the Projects tab.

Select your imported project

Click New Session next to the project you imported to start a new session with that project.

Resume a previous session

Once you have created a session with your imported project, you can close it, and later resume it. In the Astro IDE, go to the Sessions tab, and click the session you want to resume.