Skip to content
Kindgi

kindgi conversations

Conversations: multi-turn threads with one agent version (list / get / open / close / messages).

kindgi conversations list

Section titled “kindgi conversations list”

List conversations, newest first.

Terminal window
kindgi conversations list [--status=open|closed] [--replays=exclude|include|only] [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
  • --limit <value>: The most conversations to return.
  • --replays <value>: Replay conversations (a comparison's replays): exclude (the default) leaves them out, include lists them too, only lists just them.
  • --status <value>: Only the conversations with this status: open or closed.

kindgi conversations get

Section titled “kindgi conversations get”

Fetch a conversation by id.

Terminal window
kindgi conversations get <conversation-id>

kindgi conversations open

Section titled “kindgi conversations open”

Open a conversation with an agent version, pinned for every turn. A turn names it in its input: kindgi runs start --agent=<agent-id> --input='{"userMessage": "…", "conversationId": "<conversation-id>"}'.

Terminal window
kindgi conversations open <agent-id> <version> [--title=<t>] [--project=<project-id>] [--participant=<id>]

Flags:

  • --participant <value>: Your app's opaque id for the user the conversation is with.
  • --project <value>: The project the conversation is in (kindgi projects list). Default: the tenant's Default project.
  • --title <value>: A title for the conversation. Default: "Untitled conversation".

kindgi conversations close

Section titled “kindgi conversations close”

Close a conversation: it takes no more turns. Closing a closed one changes nothing.

Terminal window
kindgi conversations close <conversation-id>

kindgi conversations unregister

Section titled “kindgi conversations unregister”

Unregister a conversation: reads, lists and recall no longer return it, and it takes no more turns. The retention sweep removes it later.

Terminal window
kindgi conversations unregister <conversation-id>

kindgi conversations messages

Section titled “kindgi conversations messages”

List a conversation's messages, oldest first.

Terminal window
kindgi conversations messages <conversation-id> [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
  • --limit <value>: The most messages to return.

Every command also takes the global flags.