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

# Alpha flags

> The Cognite Toolkit uses alpha flags to enable experimental functionality that is often planned for support in the next minor release.

<Warning>
  Alpha flags enable experimental Cognite Toolkit behavior that may change or be removed without notice. Enable them only after testing and when you're willing to accept breaking changes. Product **release status** for Cognite Data Fusion is described in [release states and availability](/cdf/product_feature_status); toolkit flags are a separate CLI mechanism.
</Warning>

The Cognite Toolkit uses alpha flags to enable experimental functionality that we often plan to support in the next minor release.

By default, alpha flags aren't enabled. To enable them, you must update the [`cdf.toml`](/cdf/deploy/cdf_toolkit/api/cdf_toml) file. For example, to enable the `module-repeat` alpha flag,
add the following to your `cdf.toml` file:

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
module-repeat = true
```

## Cognite Toolkit versioning and releases

The Cognite Toolkit uses semantic versioning to manage versions as **major**, **minor**, and **patch** (for example, `0.3.17`).

* A **major** version increases with **breaking changes** in the CLI or the format of modules and configuration files. Installing a new major toolkit version may require updating your configuration files or modules.

* **Minor** versions increase with **new features** and **patch** versions with **bug fixes**.

As long as the major version is 0, breaking changes may happen between minor versions.

The Cognite Toolkit follows a release cycle of **alpha**, **beta**, and **stable** releases, shown by 'a' and 'b' in the version number.

* **Alpha** releases (for example, `0.3.0a1`) test new features, may contain breaking changes, and aren't recommended for production.
* **Beta** releases (`0.3.0b1`) focus on stability and bug fixes and are suitable for non-production testing.
* **Stable** releases (`0.3.0`) are production-ready.

Introducing new functionality in stable versions can lead to new bugs. Alpha flags allow you to selectively enable new functionality, minimizing the risk of introducing new bugs. The state of alpha flags vary, with some planned for future releases and others being experimental, requiring further testing.

## Alpha flag: import-cmd

**Status**: experimental

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
import-cmd = true
```

This flag enables the `cdf import` command. The only subcommand available is `transformation-cli`. The command
converts the `transformation-cli` manifest files to the Cognite API (Toolkit) format. Use this, for example, if you have
transformations managed by the `transformation-cli` and want to convert them to the Cognite Toolkit format.

## Alpha flag: infield

**Status**: experimental

**Available from**: `0.5.10`

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
infield = true
```

This flag enables the `infield` configuration resource. See [`cdf.toml`](/cdf/deploy/cdf_toolkit/references/resource_library#infieldv1)
for more information about the `infield` configuration resource.

## Alpha flag: migrate

**Status**: experimental

**Available from**: `0.5.45`

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
migrate = true
```

This flag enables the `cdf migrate` command. This command migrates asset-centric resources to data modeling. This
is currently an experimental feature and isn't recommended for production use.

## Alpha flag: profile

**Status**: experimental

**Available from**: `0.5.27`

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
profile = true
```

This flag enables the `cdf profile` command. This command allows you to profile CDF resources and their dependencies.
Use the `cdf profile --help` command to see the available options. Note that this command is currently in development and
will change in future releases.

## Alpha flag: create

**Status**: experimental

**Available from**: `0.7.3`

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
create = true
```

This flag enables the `create` subcommand under the `dev` plugin, which allows you to create resource YAML files from the CLI.
To use this subcommand, you need to enable the `dev` plugin. Once enabled, you can create resource YAML files with `cdf dev create`. To get more information about the subcommand, use the `--help` flag.

```shell theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
cdf dev create --help
```

## Alpha flag: extend-download

**Status**: experimental

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
extend-download = true
```

This flag enables extended download in the Data plugin, including file content, datapoints, and records. Enable the `data` plugin in `cdf.toml`, then use `cdf data download`. See [Download data using the Data plugin](/cdf/deploy/cdf_toolkit/guides/plugins/data_plugin/download).

## Alpha flag: extend-upload

**Status**: experimental

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
extend-upload = true
```

This flag enables extended upload in the Data plugin, including individual files with content and records in CSV or Parquet format. Enable the `data` plugin in `cdf.toml`, then use `cdf data upload`. See [Upload data using the Data plugin](/cdf/deploy/cdf_toolkit/guides/plugins/data_plugin/upload).

## Alpha flag: signals

**Status**: experimental

**Available from**: `0.7.166`

This flag enables **signal sinks** and **signal subscriptions** in the Cognite Toolkit. When enabled, you can add YAML files under `signals/` and deploy them with `cdf build` and `cdf deploy`. The [`YAML Reference Library`](/cdf/deploy/cdf_toolkit/references/resource_library#signals) describes the `Sink` and `Subscription` resource types.

## Alpha flag: data-products

**Status**: experimental

**Available from**: `0.7.207`

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
data-products = true
```

This flag enables **data product** resources, **rule sets**, and **rule set versions** in the Cognite Toolkit. When enabled, you can add `rulesets/` YAML files for [`RuleSet`](/cdf/deploy/cdf_toolkit/references/resource_library#ruleset) and [`RuleSetVersion`](/cdf/deploy/cdf_toolkit/references/resource_library#rulesetversion), then build and deploy them with `cdf build` and `cdf deploy`.

## Alpha flag: custom-apps

**Status**: experimental

**Available from**: `0.8.82`

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
custom-apps = true
```

This flag enables **App** and **AppVersion** resource types for deploying Cognite Flows custom apps via the CDF app-hosting API. When enabled, add YAML files under `apps/` and deploy them with `cdf build` and `cdf deploy`. See the [YAML Reference Library](/cdf/deploy/cdf_toolkit/references/resource_library#custom-apps) for configuration details.

## Alpha flag: agent-skills

**Status**: experimental

```toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
[alpha_flags]
agent-skills = true
```

This flag enables **Skill** resources for Atlas AI agents in the Cognite Toolkit. When enabled, add `.Skill.yaml` files (and Markdown sidecars) under `agents/` and deploy them with `cdf build` and `cdf deploy`. See the [YAML Reference Library](/cdf/deploy/cdf_toolkit/references/resource_library#agent-skills) for configuration details.