> ## 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
```

<Info>Human-readable output truncates long intent messages. `--json` preserves complete messages.</Info>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.