Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Share and administer admin conversations

kater admin conversations list

Lists the conversations that started in the window, newest first, 40 at a time.

Each row has who asked, their first question, the topic, how many questions and calls, and Could not answer when the last call failed.

Examples

Terminal window
# List the conversations of the last 30 days
kater admin conversations list
# List one person's conversations about paid media in the last 90 days
kater admin conversations list --window 90 --person you@example.com --topic "paid media"
# Find the conversations that ask about ROAS
kater admin conversations list --search roas

Options

OptionDescription
--window <days>How many days the list covers, ending today: 1 to 90, and 30 when you leave it out. A conversation is in the window when it started in it. The default is 30.
--person <email>Lists only this person’s conversations. Repeat it for more people. You can give it more than one time.
--topic <topic>Lists only the conversations with this topic, in lower case, as the list’s Topics line names it. Repeat it for more topics. You can give it more than one time.
--failedLists only the conversations Kater could not answer: their last call failed.
--search <words>Lists only the conversations whose questions or summary hold these words. Case does not matter.
--cursor <cursor>Reads the next page. The list gives the whole command for the next page on its More line.

It also takes the global options --json, --kater-root, --scope and --help.

What it shows

First, how many conversations match, and each filter’s counts: each person, each topic, and how many Kater answered. Then the rows, by day, with the times in UTC. A question that is not the person’s words starts with “The agent’s summary”: the agent sent no words before Kater asked for them. Each row ends with the conversation’s ID, for kater admin conversations show.

See also