> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# momentic import

> Import tests, modules, and environments from the Momentic dashboard.

Pulls dashboard-managed tests, modules, and environments down into the current
project. You can import individual tests by their dashboard path, an entire
cloud folder (which brings every test and module inside it plus any nested
subfolders), or omit arguments to import the entire workspace. When the imported
entities live inside dashboard folders, the folder hierarchy is recreated on
disk so your local layout mirrors the dashboard.

```bash theme={null}
npx momentic import
```

## Arguments

<ParamField path="[paths...]" type="string">
  One or more dashboard paths to import. A path can be either a test path (e.g.
  `tests/checkout/happy-path`) or a folder path using the slash-separated cloud
  folder hierarchy (e.g. `auth/onboarding`). When omitted, every test, module,
  and environment in the project is imported.
</ParamField>

## How folder import works

* Folder paths are resolved against the dashboard's folder tree
  case-insensitively. `auth/onboarding` matches the cloud folder named
  `Onboarding` nested under `Auth`.
* All tests and modules inside the folder are imported, including those in any
  nested subfolders.
* The cloud folder hierarchy is recreated on disk. A test in cloud folder
  `Auth/Onboarding` lands at `auth/onboarding/<test-name>.test.yaml` relative to
  the project root. Folder names are slugified the same way test names are.
* If a test or module already exists locally with the same id, it keeps its
  current on-disk location; existing flat layouts are not reshuffled.

## Examples

Import every dashboard-managed resource into the local project:

```bash theme={null}
npx momentic import
```

Import a single test by its dashboard path:

```bash theme={null}
npx momentic import tests/checkout/happy-path
```

Import every test and module inside a cloud folder, recreating the folder
hierarchy on disk:

```bash theme={null}
npx momentic import auth/onboarding
```

Import multiple folders and a specific test in one command:

```bash theme={null}
npx momentic import auth/onboarding checkout tests/smoke/login
```