Skip to main content
aion chat provides a quick interactive client for local testing.

​
Usage

aion chat [OPTIONS]

​
Key Options

OptionDescription
--hostAgent or proxy URL. Default http://localhost:10000.
--agent-idAgent identifier when connecting through proxy.
--sessionSession ID (0 generates a random session).
--historyShow task history in the interface.
--push-notificationsEnable push notification mode.
--push-receiverPush receiver URL when notifications are enabled.
--headerAdd custom request headers (key=value, repeatable).
--extensionsComma-separated extension URI list.
--no-streamDisable streaming; use message/send even if the agent supports streaming.

​
Examples

# Basic local chat
aion chat

# Chat through proxy for specific agent
aion chat --host http://localhost:10000 --agent-id support

# Continue a named session with history
aion chat --session 12345 --history

# Send custom headers and extension activation
aion chat --header "X-Client=aion-cli" --extensions "https://docs.aion.to/extensions/aion/traceability/1.0.0"

# Disable streaming (use message/send regardless of agent capabilities)
aion chat --no-stream