Conversation Commands

Manage persistent conversations and stream their events.

Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.

bctrl conversations list

List conversations

$
bctrl conversations list [flags]

bctrl conversations create

Create a conversation

$
bctrl conversations create

bctrl conversations get

Get a conversation and its messages

$
bctrl conversations get <conversationId>

bctrl conversations patch

Update the model, toolset, or title

$
bctrl conversations patch <conversationId>

bctrl conversations message

Send a message and start an agent turn

$
bctrl conversations message <conversationId>

bctrl conversations cancel

Cancel the active agent turn

$
bctrl conversations cancel <conversationId>

bctrl conversations stream

Stream normalized conversation events

$
bctrl conversations stream <conversationId> [flags]