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

# Chat commands

> Manage analysis chats.

<Note>The Bevor CLI is coming soon. This page previews its planned command interface.</Note>

Manage analysis chats.

## `bevor chat list`

```bash theme={null}
bevor chat list [OPTIONS]
```

| Parameter         | Type    | Required | Default | Description       |
| ----------------- | ------- | -------- | ------- | ----------------- |
| `--page-size, -n` | integer | No       | 20      | Results per page. |
| `--json, -j`      | boolean | No       | false   | Output raw JSON.  |

## `bevor chat get`

```bash theme={null}
bevor chat get [OPTIONS] CHAT_ID
```

| Parameter    | Type    | Required | Default | Description      |
| ------------ | ------- | -------- | ------- | ---------------- |
| `CHAT_ID`    | string  | Yes      | —       | Chat ID.         |
| `--json, -j` | boolean | No       | false   | Output raw JSON. |

## `bevor chat messages`

```bash theme={null}
bevor chat messages [OPTIONS] CHAT_ID
```

| Parameter         | Type    | Required | Default | Description        |
| ----------------- | ------- | -------- | ------- | ------------------ |
| `CHAT_ID`         | string  | Yes      | —       | Chat ID.           |
| `--page-size, -n` | integer | No       | 50      | Messages per page. |
| `--json, -j`      | boolean | No       | false   | Output raw JSON.   |

## `bevor chat new`

Create a chat thread and open the streaming terminal session.

```bash theme={null}
bevor chat new [OPTIONS]
```

| Parameter   | Type   | Required | Default | Description                                                     |
| ----------- | ------ | -------- | ------- | --------------------------------------------------------------- |
| `--version` | string | No       | None    | Analysis version id (default: head of the configured analysis). |

## `bevor chat resume`

Open the streaming session for an existing thread.

```bash theme={null}
bevor chat resume CHAT_ID
```

| Parameter | Type   | Required | Default | Description                                     |
| --------- | ------ | -------- | ------- | ----------------------------------------------- |
| `CHAT_ID` | string | Yes      | —       | Thread id (`bevor chat list --json`, field id). |