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

# nmp CLI

> Install and use the read-oriented NMotion Platform CLI.

`nmp` is the installable Python client for the developer API. Source lives in `clients/python/`.

## Install

```bash theme={null}
uv tool install ./clients/python
# or
pipx install ./clients/python
```

## Configure

```bash theme={null}
nmp auth token set             # paste nmp_… into keyring / file store
nmp auth token status          # show configured base URL / whether a token is set
```

Environment variables:

| Variable         | Purpose                                                   |
| ---------------- | --------------------------------------------------------- |
| `NMP_API_TOKEN`  | Bearer token (overrides stored credentials)               |
| `NMP_BASE_URL`   | API origin (default `https://platform.neural-motion.org`) |
| `NMP_CONFIG_DIR` | Override config directory (useful in tests)               |

Public commands (`version`, catalog) do **not** attach a stored PAT, so an alternate `--base-url` cannot accidentally leak production credentials.

## Common commands

```bash theme={null}
nmp version
nmp whoami --json
nmp orgs list --json
nmp projects list --org <org> --json
nmp catalog datasets list --json
nmp catalog datasets get <dataset_id> --json
nmp datasets list --org <org> --project <project> --json
nmp datasets get --org <org> --project <project> <dataset_slug> --json
nmp datasets manifest --org <org> --project <project> <dataset_slug> --json
nmp episodes list --org <org> --project <project> --dataset <slug> --json
nmp episodes get --org <org> --project <project> --dataset <slug> <index> --json
```

Pass `--base-url https://dev.platform.neural-motion.org` to target the dev channel.