> This page is for Experience Orchestration.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful-staging.ferndocs.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful-staging.ferndocs.com/developers/docs/_mcp/server.

# Install the design system CLI

> Install and configure the Contentful design system CLI for importing Component Types and tokens into Contentful.

## Install the CLI

Clone the [SDK repository](https://github.com/contentful/experience-design-system-sdk-public) and build from source:

```bash
git clone https://github.com/contentful/experience-design-system-sdk-public.git
cd experience-design-system-sdk-public
pnpm install
pnpm build
```

Link the CLI globally so the `experiences` binary is available on your PATH:

```bash
cd packages/experience-design-system-cli
pnpm link --global
```

## Prerequisites

Before running the CLI, ensure you have the following:

* **Node.js 24+**
* **pnpm 10.27+**
* **A coding agent CLI** — One of the following, installed and authenticated:
  * [Claude Code](https://docs.anthropic.com/claude-code) (`claude`)
  * [OpenAI Codex](https://openai.com/codex) (`codex`)
  * [OpenCode](https://opencode.ai) (`opencode`)
  * [Cursor](https://www.cursor.com) (`cursor`) — supported via `--agent cursor` but not auto-detected by `experiences setup`
* **A Contentful Management API (CMA) token** — Generate one in the Contentful web app under **Settings > API keys > Content management tokens**.
* **A Contentful space with Experiences enabled**

> **Info**
>
> Run `experiences setup` to install a coding agent and configure your Contentful credentials automatically. See [Set up your environment](#set-up-your-environment).

## Set up your environment

Run the interactive setup wizard to install a coding agent and configure your Contentful credentials:

```bash
experiences setup
```

![experiences setup wizard](/developers/docs/_fern-img/467fa9b54d2d42b8a0d9678645052134d4308b8e03326a32b0adcefcb4eb6157.webp)

The wizard walks you through the following steps:

1. **Node.js** — Detects nvm or fnm and offers to install Node 24.
2. **pnpm** — Installs via corepack or npm.
3. **Install and build** — Runs `pnpm install && pnpm build` from the monorepo root.
4. **Coding agent** — Detects claude, codex, or opencode on your PATH. If none are found, presents a menu to install one.
5. **Contentful credentials** — Prompts for CMA token, space ID, and environment ID. Saves them to `~/.config/experiences/credentials.json` so they pre-fill in future sessions.
6. **Optional extras** — Configure `EDS_EXTRACT_CONCURRENCY` for parallel extraction and `NO_COLOR` preference.

To skip individual steps:

```bash
experiences setup --skip-build --skip-agent --skip-credentials --skip-optional
```

## Verify your environment

To check your environment at any time, run:

```bash
experiences doctor
```

## Next steps

Continue with these guides:

* **[Import components](/experience-orchestration/import-components)** — Run the Component Type import pipeline.
* **[Import design tokens](/experience-orchestration/import-design-tokens)** — Import design tokens from your codebase.