> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# Conversation Commands

> Manage persistent conversations and stream their events.

Manage persistent conversations and stream their events.

Output formatting flags (`--json`, `--jq`, and `--template`) are documented once in [Output Formatting](/cli/output) and are omitted from the tables below.

## `bctrl conversations list`

List conversations

```bash
bctrl conversations list [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl conversations create`

Create a conversation

```bash
bctrl conversations create
```

## `bctrl conversations get`

Get a conversation and its messages

```bash
bctrl conversations get <conversationId>
```

## `bctrl conversations patch`

Update the model, toolset, or title

```bash
bctrl conversations patch <conversationId>
```

## `bctrl conversations message`

Send a message and start an agent turn

```bash
bctrl conversations message <conversationId>
```

## `bctrl conversations cancel`

Cancel the active agent turn

```bash
bctrl conversations cancel <conversationId>
```

## `bctrl conversations stream`

Stream normalized conversation events

```bash
bctrl conversations stream <conversationId> [flags]
```

| Flag               | Description                  |
| ------------------ | ---------------------------- |
| `--after <cursor>` | Resume after a stream cursor |