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

# insights category create

> Create an intent category in an Alpic environment

Create an intent category, optionally linking it to existing intents.

## Usage

```bash theme={null}
alpic insights category create
```

Prompts for a name and creates the category in the environment from the local `.alpic` configuration.

## Extended Usage

Create a category with an explicit name and color:

```bash theme={null}
alpic insights category create --name Scheduling --color blue
```

When `--color` is omitted, a color is derived from the category name. Available colors: `red`, `orange`, `yellow`, `green`, `blue`, `purple`, `pink`, `gray`.

Link the new category to existing intents right away:

```bash theme={null}
alpic insights category create \
  --name Scheduling \
  --intent-id <intentId> \
  --intent-id <intentId>
```

Create in automation and print the created category:

```bash theme={null}
alpic insights category create --environment-id <environmentId> --name Scheduling --json --non-interactive
```

<Note>`--name` is required in non-interactive mode.</Note>

## Options

| Flag                 | Description                                            | Default |
| -------------------- | ------------------------------------------------------ | ------- |
| `--environment-id`   | Select an environment by ID                            |         |
| `--environment-name` | Select an environment by name                          |         |
| `--project-id`       | Provide the project context by ID                      |         |
| `--project-name`     | Provide the project context by name                    |         |
| `--name`             | The category name                                      |         |
| `--color`            | The category color; derived from the name when omitted |         |
| `--intent-id`        | Link the new category to this intent ID. Repeatable.   |         |
| `--json`             | Print the unmodified API response as JSON              | `false` |
| `--non-interactive`  | Skip interactive prompts                               |         |

<Tip>When the current directory is linked to an environment, the environment and project flags can be omitted.</Tip>