Skip to Content
kusaw docsv1.0.0
CLI reference

kusaw conversation

List, show, and answer step conversations

kusaw conversation

List, show, and answer step conversations

Usage

Text
kusaw conversation [flags]

Flags

NameShortTypeDefaultDescription
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--factorystringfactory name from kusaw list
--help-hboolfalsehelp for conversation

Subcommands

kusaw conversation attach

Follow a conversation and answer its questions in this terminal

Text
kusaw conversation attach <id> [flags]
NameShortTypeDefaultDescription
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--factorystringfactory name from kusaw list
--help-hboolfalsehelp for attach

Example:

Text
kusaw conversation attach 01JD5Q --factory demo

kusaw conversation cancel

Cancel a conversation

Text
kusaw conversation cancel <id> [flags]
NameShortTypeDefaultDescription
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--factorystringfactory name from kusaw list
--help-hboolfalsehelp for cancel
--yesboolfalseCancel without a prompt

Example:

Text
kusaw conversation cancel 01JD5Q --yes

kusaw conversation list

List open conversations; --all includes finished ones

Text
kusaw conversation list [flags]
NameShortTypeDefaultDescription
--allboolfalseInclude finished conversations
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--factorystringfactory name from kusaw list
--help-hboolfalsehelp for list
--jsonboolfalsePrint JSON

Example:

Text
kusaw conversation list --factory demo --all

kusaw conversation reply

Answer the latest question of a conversation

Text
kusaw conversation reply <id> [text] [flags]
NameShortTypeDefaultDescription
--choicestringPick one of the question's choices by id
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--factorystringfactory name from kusaw list
--filestringRead the answer from a file; - reads stdin
--help-hboolfalsehelp for reply

Example:

Text
kusaw conversation reply 01JD5Q "Use Postgres" --factory demo

kusaw conversation retry

Send an interrupted conversation's last answer again

Text
kusaw conversation retry <id> [flags]
NameShortTypeDefaultDescription
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--factorystringfactory name from kusaw list
--help-hboolfalsehelp for retry

Example:

Text
kusaw conversation retry 01JD5Q --factory demo

kusaw conversation show

Show one conversation's questions and answers

Text
kusaw conversation show <id> [flags]
NameShortTypeDefaultDescription
--configstringPath to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
--factorystringfactory name from kusaw list
--help-hboolfalsehelp for show
--jsonboolfalsePrint JSON

Example:

Text
kusaw conversation show 01JD5Q --factory demo

Exit codes

CodeNameDescription
0okSuccess.
1errorRuntime error.
2usageUsage or validation error.
3rejectedControl request rejected; the error string is printed verbatim.
4not picked upControl request not picked up within the wait time while serve runs.

Example

Text
kusaw conversation list --factory demo

On this page