> ## 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 intent list

> List grouped user intents for an Alpic environment

List grouped examples of what users tried to accomplish, including occurrence counts, tools, clients, and categories.

## Usage

```bash theme={null}
alpic insights intent list
```

Lists intents from the last seven days for the environment in the local `.alpic` configuration.

## Extended Usage

Select an environment by ID and use an explicit time range:

```bash theme={null}
alpic insights intent list \
  --environment-id <environmentId> \
  --since 2026-08-01T00:00:00Z \
  --until 2026-08-08T00:00:00Z
```

Select an environment by name within a project:

```bash theme={null}
alpic insights intent list --project-name my-project --environment-name production
```

The project can also be selected by ID:

```bash theme={null}
alpic insights intent list --project-id <projectId> --environment-name production
```

Filter and page through grouped intents:

```bash theme={null}
alpic insights intent list \
  --search scheduling \
  --tool create-event \
  --tool update-event \
  --client-id claude-desktop \
  --category-id <categoryId> \
  --sort asc \
  --limit 100 \
  --offset 100
```

Emit the complete API response for automation:

```bash theme={null}
alpic insights intent list --environment-id <environmentId> --json --non-interactive
```

<Note>Human-readable output truncates long intent messages. `--json` preserves complete messages.</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                      |         |
| `--since`            | Show intents after a relative duration or ISO 8601 date  | `7d`    |
| `--until`            | Show intents before a relative duration or ISO 8601 date | now     |
| `--search`           | Search intent messages, tools, and categories            |         |
| `--tool`             | Filter by tool name. Repeatable.                         |         |
| `--client-id`        | Filter by stable MCP client ID. Repeatable.              |         |
| `--category-id`      | Filter by category ID. Repeatable.                       |         |
| `--sort`             | Sort by date: `asc` or `desc`                            | `desc`  |
| `--limit`            | Return between 1 and 200 grouped intents                 | `50`    |
| `--offset`           | Skip this many grouped intents                           | `0`     |
| `--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>