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

# CLI Conversations

> List, inspect, export, and manage conversation history and message feedback from the terminal.

Use conversation and message commands to inspect chat history, export transcripts, submit client-side tool results, and set feedback on assistant replies. For REST details, see [User Conversations](/docs/api-v2/user-conversations). Authenticate first — see [CLI Auth](/docs/cli/auth). Most commands require an agent ID (`-a agt_123`) or a [default agent](/docs/cli/config).

## List API-created conversations

List conversations created programmatically through the API, newest first:

```bash theme={null}
chatbase conversations list -a agt_123
```

List conversations for a specific user:

```bash theme={null}
chatbase conversations list -a agt_123 --user usr_456
```

Fetch every page as JSON:

```bash theme={null}
chatbase conversations list -a agt_123 --all --json
```

<Note>
  `conversations list` returns only API-created conversations. Conversations from the chat bubble and external integrations (Slack, WhatsApp, Instagram, Messenger, and the like) are not included and are not counted in `total`. Use `conversations export` to read conversations from every source.
</Note>

## Get one conversation

Show metadata for a single API-created conversation:

```bash theme={null}
chatbase conversations get conv_123 -a agt_123
```

You can pass the ID as an argument or with `--conversation`:

```bash theme={null}
chatbase conversations get --conversation conv_123 -a agt_123
```

## Export all conversations

Export conversations from every source with full message history embedded:

```bash theme={null}
chatbase conversations export -a agt_123
```

Write the full export to a file:

```bash theme={null}
chatbase conversations export -a agt_123 --all -o export.json
```

Each exported item includes its own `messages` array, so you do not need follow-up `conversations get` or `messages list` calls. Export is the only way to read bubble and integration conversations from the CLI — `get` and `messages list` work only for API-created conversations.

<Tip>
  Use `--limit` (1–20, default 20) when processing large exports page by page. See [Exporting All Conversations](/docs/api-v2/user-conversations#exporting-all-conversations) for source types and message format.
</Tip>

## Submit client-side tool results

When a chat response pauses on a client-side tool call, submit the result so the turn can continue:

```bash theme={null}
chatbase conversations tool-result conv_123 --tool-call-id tc_1 --output '{"temperature": 72}' -a agt_123
```

Pass JSON from a file with `@result.json`, or omit `--output` to send an empty result. See [Client Actions](/docs/api-v2/client-actions) for how tool calls and results work.

```bash theme={null}
chatbase conversations tool-result conv_123 --tool-call-id tc_1 --output @result.json -a agt_123
```

Send an empty result when the tool produced no output:

```bash theme={null}
chatbase conversations tool-result conv_123 --tool-call-id tc_1 -a agt_123
```

## List messages

List messages in an API-created conversation:

```bash theme={null}
chatbase messages list --conversation conv_123 -a agt_123
```

Fetch every page as JSON:

```bash theme={null}
chatbase messages list --conversation conv_123 -a agt_123 --all --json
```

## Set message feedback

Rate an assistant message:

```bash theme={null}
chatbase messages feedback msg_1 --conversation conv_123 --rating positive -a agt_123
```

Clear existing feedback:

```bash theme={null}
chatbase messages feedback --conversation conv_123 --message msg_1 --rating clear -a agt_123
```

Ratings are `positive`, `negative`, or `clear`.

## Commands

| Command                              | Purpose                                                           |
| ------------------------------------ | ----------------------------------------------------------------- |
| `chatbase conversations export`      | Export conversations from every source, with full message history |
| `chatbase conversations get`         | Show one API-created conversation                                 |
| `chatbase conversations list`        | List an agent's API-created conversations                         |
| `chatbase conversations tool-result` | Submit a client-side tool result to a chat turn                   |
| `chatbase messages feedback`         | Set or clear user feedback on an assistant message                |
| `chatbase messages list`             | List messages in a conversation                                   |

<Note>
  For every flag, run `chatbase conversations <command> --help` or `chatbase messages <command> --help`.
</Note>