Skip to main content
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. Authenticate first — see CLI Auth. Most commands require an agent ID (-a agt_123) or a default agent.

​
List API-created conversations

List conversations created programmatically through the API, newest first:
List conversations for a specific user:
Fetch every page as JSON:
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.

​
Get one conversation

Show metadata for a single API-created conversation:
You can pass the ID as an argument or with --conversation:

​
Export all conversations

Export conversations from every source with full message history embedded:
Write the full export to a file:
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.
Use --limit (1–20, default 20) when processing large exports page by page. See Exporting All Conversations for source types and message format.

​
Submit client-side tool results

When a chat response pauses on a client-side tool call, submit the result so the turn can continue:
Pass JSON from a file with @result.json, or omit --output to send an empty result. See Client Actions for how tool calls and results work.
Send an empty result when the tool produced no output:

​
List messages

List messages in an API-created conversation:
Fetch every page as JSON:

​
Set message feedback

Rate an assistant message:
Clear existing feedback:
Ratings are positive, negative, or clear.

​
Commands

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