chat agent, or the agent named with --agent, and streams its answer to stdout. Piped stdin is appended to the message as input context.
Put --thread after the message, since it takes an optional value. On an existing thread, --agent must name the thread’s owner.
With --json, prints {content, tool_calls_made, tools_used, usage, thread_id, agent} instead of streaming.
Arguments
string
The message; reads stdin when omitted and piped
Options
string
Run a named agent instead of the default
chat agentFormat: AGENT.string
Continue a thread:
--thread <id> for a specific one, bare --thread for the most recent. Omit to start a new threadFormat: THREAD.The value is optional: --thread on its own is accepted.boolean
Emit a JSON envelope instead of streaming text
boolean
Print the final answer only, without streaming
Global options
integer
Increase log verbosity (-v info, -vv debug, -vvv trace)