> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://contentful.com/developers/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server. # Command reference > Full flag reference for the experiences import wizard and the individual pipeline commands. This page lists every flag on `experiences import` and the individual pipeline commands (`analyze extract`, `analyze select-agent`, `analyze select`, `generate components`, `apply preview`, `apply select`, `apply push`). See [Import components](/experience-orchestration/import-components) for the guided walkthrough and [Run the pipeline step by step](/experience-orchestration/pipeline-steps) for the per-step recipes. ## Manifest deletion safety Manifest preview and apply skip deletions by default. Components and design tokens that exist in the target environment but are missing from the manifest are omitted from the diff, so no delete actions are emitted. Pass `--allow-deletions` to `experiences import`, `experiences apply select`, or `experiences apply push` to include removals. Published entities are excluded from deletion, and components referenced by Fragments remain protected. `experiences apply preview` is read-only and always skips deletions. ## Credential precedence Credentials — `--space-id`, `--environment-id`, `--cma-token`, and `--host` — resolve in a fixed order. The order depends on which surface receives them: **Interactive `experiences import` (the wizard):** 1. Values you enter in the wizard's Credentials step during this run. 2. Values saved via `experiences setup` (stored on disk at `~/.config/experiences/credentials.json`). 3. Environment variables `CONTENTFUL_SPACE_ID`, `CONTENTFUL_ENVIRONMENT_ID`, `CONTENTFUL_MANAGEMENT_TOKEN`, `EDS_HOST`. Only used as a fallback when the disk value for that field is empty. Saved (disk) values take precedence over environment variables so that credentials you deliberately configured with `experiences setup` are not silently overridden by whatever happens to be in your shell. When environment variables are set, `experiences setup` prints a warning to make the shadowing behavior visible. **Headless / individual commands (`--push-from-run`, `--skip-*`, `apply preview`, `apply select`, `apply push`, and non-TTY `experiences import`):** 1. Command-line flag values (`--space-id`, `--environment-id`, `--cma-token`, `--host`). 2. Environment variables (`CONTENTFUL_SPACE_ID`, `CONTENTFUL_ENVIRONMENT_ID`, `CONTENTFUL_MANAGEMENT_TOKEN`, `EDS_HOST`). Values saved via `experiences setup` are **not** consulted on the headless path — pass credentials via flags or environment variables. This mirrors typical CI conventions and keeps scripted runs deterministic. ## experiences import Common flags: | **Flag** | **Purpose** | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--project ` | Path to the project root to analyze. | | `--space-id ` | Contentful space ID. Required unless `--skip-apply` or `--no-push`. See [Credential precedence](#credential-precedence). | | `--environment-id ` | Contentful environment ID. Required unless `--skip-apply` or `--no-push`. See [Credential precedence](#credential-precedence). | | `--cma-token ` | CMA personal access token. See [Credential precedence](#credential-precedence). | | `--host ` | Override the Contentful API base URL (for example, when targeting a non-production stack). | | `--agent ` | Coding agent to use (`claude`, `codex`, `opencode`, `cursor`). Overrides the stored preference. | | `--model ` | Model override for the selected agent. Supported across all four agents; each agent picks a default lightweight model when the flag is omitted. | | `--raw-tokens ` | Raw token source file (SCSS, CSS variables, JS/TS, Style Dictionary, Tailwind) to classify alongside components. | | `--tokens ` | Pre-classified DTCG `tokens.json` sidecar to push alongside components. | | `--auto-filter` / `--no-auto-filter` | Force the AI scope pre-filter on or off, overriding the stored preference. | | `--no-live-preview` | Disable the manifest preview that re-runs after each field edit in the wizard's final-review step. | | `--auto-accept-scope` | Accept all extracted components without prompting. Required when running in a non-interactive shell (for example, CI pipelines). | | `--out-dir ` | Save directory for `components.json` / `tokens.json`. Bypasses the inline save-path prompt. | | `--on-conflict ` | `overwrite`, `skip`, or `fail` when files exist at the save path. | | `--no-save` | Push without writing files to disk. | | `--no-push` | Run extract → scope → generate → final-review and exit without pushing. | | `--push-from-run ` | Push a prior recorded run without regenerating. See [Run history and replay](/experience-orchestration/run-history). | | `--modify ` | Re-open the wizard at final-review with a prior run pre-populated. See [Run history and replay](/experience-orchestration/run-history). | | `--allow-deletions` | Include components and design tokens missing from the manifest in removal actions. Disabled by default. | | `--overwrite` / `--save-as-new` | Only with `--modify`: save back to the run's recorded path, or always save to a new path. | | `--force` | Bypass staleness checks with `--push-from-run` / `--modify`. | | `--select-prompt-path ` | Custom `.md` skill prompt for `analyze select-agent`. A banner is shown when active. | | `--generate-prompt-path ` | Custom `.md` skill prompt for `generate components`. A banner is shown when active. | | `--no-cache` | Bypass the select and generate caches (forwards through spawned subprocesses). | | `--yes` | Skip the interactive confirmation prompt during the apply-push step. | | `--verbose` | Show full agent output and per-entity progress. | | `--print-prompt` | Print the generate prompt to stdout and exit without invoking the agent. | | `--debug` / `--no-debug` | Enable or force off the redacted JSONL trace at `~/.contentful/experience-design-system-cli/debug/`. See [Debug logging](/experience-orchestration/debug-logging). | Advanced flags for headless pipelines and partial runs: | **Flag** | **Purpose** | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--out ` | Directory for pipeline artifacts (extract sessions, generated JSON). Distinct from `--out-dir`, which sets the final save-path for `components.json` / `tokens.json`. | | `--select-all` | Accept every extracted component without prompting. Headless equivalent of the scope gate's accept-all action. | | `--select ` | Include only components matching this pattern. Repeatable. | | `--deselect ` | Exclude components matching this pattern. Repeatable. | | `--skip-analyze` | Reuse the most recent extract session instead of re-scanning. | | `--skip-generate` | Reuse the most recent generate session instead of re-generating. | | `--skip-apply` | Stop after generate; do not push to Contentful. Makes `--space-id` / `--environment-id` / `--cma-token` optional. | | `--exclude-invalid` | Automatically reject components with validation errors (empty names, collisions). | | `--print` | Write `components.json` to `--out` after generation completes. | | `--viewports ` | JSON file with a viewport array, forwarded to apply push. | > **Info** > > `--dry-run` still works but emits a stderr deprecation notice. Use `--print-prompt` instead. Composite mode and composition sources. See [Coded components](/experience-orchestration/coded-components) for the full explanation: | **Flag** | **Purpose** | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--atomic` | Import a flat list of components with no embedded-component hierarchy. This is the default. | | `--composite` | Import the embedded-component hierarchy (opt in). Wins if both `--composite` and `--atomic` are passed. | | `--composition-map ` | Consume a hand-authored `parent → children` interchange map. Deterministic, and outranks the agent. Implies `--composite`. | | `--generate-map ` | Also write a composition-map skeleton from the resolved edges during extraction, ready to hand-edit and feed back via `--composition-map`. Implies `--composite`. | | `--composition-agent` | Resolve the hierarchy with a coding agent when the deterministic sources find no groups. Best effort and cached. Implies `--composite`. | | `--composition-agent-mode ` | `parser` (the default, where the agent writes a sandboxed parser) or `edges` (the agent lists relationships directly). | | `--composition-refresh` | Bypass the composition cache and re-resolve from scratch, forcing the agent to run. Implies `--composite`. | | `--prompt ` | Override a stage prompt. `value` is a file path or literal text, for example `--prompt composition=./prompt.md`. Repeatable. | | `--auto-reject-cycles` | Automatically reject the components in a slot dependency cycle and continue, instead of blocking. See [Slot dependency cycles](/experience-orchestration/coded-components#slot-dependency-cycles). | > **Info** > > Any composition source flag implies `--composite`, so you rarely pass `--composite` explicitly once you use one. The edge-source precedence is code slots, then map, then agent. ## experiences analyze extract | **Flag** | **Purpose** | | ------------------ | ------------------------------------------------ | | `--project ` | Path to the project root to scan. | | `--dir ` | Scan a specific subdirectory within the project. | | `--session ` | Reuse a specific extract session ID. | ## experiences analyze select-agent | **Flag** | **Purpose** | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--agent ` | Coding agent to use for the scope decision. | | `--model ` | Model override for the selected agent. | | `--session ` | Analyze select-agent decisions are stored against this pipeline session. | | `--select-prompt-path ` | Custom `.md` skill prompt for the select agent. A banner is shown when active. | | `--no-cache` | Bypass the per-component select cache. | | `--show-rationale` | Print the decisions and rationale that a prior `select-agent` run recorded for this session. Read-only — reads the persisted rationale from the session database without invoking the agent. | | `--json` | With `--show-rationale`, emit machine-readable JSON. | | `--verbose` | Display detailed agent output. | | `--print-prompt` | Print the select prompt to stdout and exit. | ## experiences analyze select The standalone interactive TUI for reviewing extracted components. | **Flag** | **Purpose** | | ---------------------- | ----------------------------------------------------------- | | `--session ` | Load a specific extract session into the TUI. | | `--select-all` | Accept every extracted component without launching the TUI. | | `--select ` | Accept components matching this pattern. Repeatable. | | `--deselect ` | Reject components matching this pattern. Repeatable. | ## experiences generate components | **Flag** | **Purpose** | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `--agent ` | Coding agent to use. | | `--model ` | Model override for the selected agent. | | `--tokens ` | Design token file for prop resolution. | | `--token-map ` | Token-map file for token-to-prop binding. | | `--generate-prompt-path ` | Custom `.md` skill prompt for the generate agent. A banner is shown when active; the cache is isolated by prompt hash. | | `--session ` | Persist generated definitions against this pipeline session. | | `--no-cache` | Bypass cached results and regenerate all definitions. | | `--verbose` | Display detailed agent output. | | `--print-prompt` | Print the generate prompt to stdout and exit. | ## experiences apply preview | **Flag** | **Purpose** | | ----------------------- | ------------------------------------------------------------------------------------------- | | `--space-id ` | Contentful space ID. Required. | | `--environment-id ` | Contentful environment ID. Required. | | `--cma-token ` | CMA personal access token. Also read from `CONTENTFUL_MANAGEMENT_TOKEN`. | | `--host ` | Override the Contentful API base URL. | | `--components ` | Path to a `components.json` (CDF) file to preview from disk instead of the current session. | | `--tokens ` | Path to a `tokens.json` (DTCG) file to include in the preview. | | `--session ` | Load generated components from a specific pipeline session ID. | ## experiences apply select | **Flag** | **Purpose** | | ----------------------- | ------------------------------------------------------------------------------------------------------- | | `--space-id ` | Contentful space ID. Required. | | `--environment-id ` | Contentful environment ID. Required. | | `--cma-token ` | CMA personal access token. Also read from `CONTENTFUL_MANAGEMENT_TOKEN`. | | `--host ` | Override the Contentful API base URL. | | `--components ` | Path to a `components.json` (CDF) file to load from disk instead of the current session. | | `--tokens ` | Path to a `tokens.json` (DTCG) file. | | `--session ` | Load generated components from a specific pipeline session ID. | | `--select-all` | Select all entities without launching the TUI. | | `--select ` | Select entities by ID pattern. Repeatable. | | `--deselect ` | Deselect entities by ID pattern. Repeatable. | | `--allow-deletions` | Include components and design tokens missing from the manifest in removal actions. Disabled by default. | | `--force` | Skip confirmation for breaking changes (field removals, type changes). | ## experiences apply push | **Flag** | **Purpose** | | ----------------------- | ------------------------------------------------------------------------------------------------------- | | `--space-id ` | Contentful space ID. Required. | | `--environment-id ` | Contentful environment ID. Required. | | `--cma-token ` | CMA personal access token. Also read from `CONTENTFUL_MANAGEMENT_TOKEN`. | | `--host ` | Override the Contentful API base URL. | | `--components ` | Path to a `components.json` (CDF) file to push from disk instead of the current session. | | `--tokens ` | Path to a `tokens.json` (DTCG) file. | | `--session ` | Load generated components from a specific pipeline session ID. | | `--allow-deletions` | Include components and design tokens missing from the manifest in removal actions. Disabled by default. | | `--yes` | Skip the interactive confirmation prompt. | | `--verbose` | Show all entity progress, including skipped and unchanged entities. | | `--force` | Skip confirmation for breaking changes (for CI pipelines). | | `--dry-run` | Run the preview step only without pushing. |