Skip to main content
Aion Chat terminal interface Aion Chat is a terminal interface for chatting with A2A-compatible agents. It can run through the Python SDK CLI inside an Aion project, or as a standalone Node package installed from npm.

​
Choose an Install Path

PathBest for
Python SDK CLIProjects that implement agents with the Aion Python SDK.
Standalone npm packageA terminal chat client without installing the Python SDK.

​
Python SDK CLI

Install the Python SDK CLI from the Python SDK installation guide. Then run chat from your project: 
poetry run aion chat
By default, aion chat connects to http://localhost:8000. That default is useful when you are running a local Aion proxy or agent server with the Python SDK. Target a different endpoint: 
poetry run aion chat --url http://localhost:8000
Target a specific agent through a proxy: 
poetry run aion chat --url http://localhost:8000 --agent-id support
See Command Line Interface for the broader Python SDK CLI.

​
Standalone npm Package

Install the standalone chat tool globally: 
npm install -g @terminal-research/aion
Run the primary executable: 
aio
By default, aio connects to http://localhost:8000. The package also installs an aion-chat alias: 
aion-chat

​
Options

OptionDefaultDescription
--url, --host, -uhttp://localhost:8000Agent or proxy URL to connect to.
--agent-idnoneAgent identifier for proxy-aware routing.
--tokennoneBearer token for authenticated endpoints.
--headernoneCustom HTTP header in key=value format. Repeatable.
--push-notificationsdisabledStart the local push notification receiver.
--no-push-notificationsdisabledExplicitly disable push notifications.
--push-receiverhttp://localhost:5000Push notification receiver URL.
--helpn/aShow help text.
--versionn/aPrint the package version.

​
Examples

Connect to the default local endpoint: 
aio
Connect through a local proxy and select an agent: 
aio --url http://localhost:8000 --agent-id onboarding
Send an authenticated request: 
aio --url https://agent.example.com --token "$AION_TOKEN"
Add custom headers: 
aio --header "X-Client=aion-docs" --header "X-Trace=demo"
Enable push notifications: 
aio --push-notifications --push-receiver http://localhost:5000

​
Composer Controls

ControlBehavior
EnterSend the message or select the active menu item.
Shift+EnterInsert a newline.
@Open the agent picker.
/Open the slash command picker.
EscDismiss the active menu or clear the draft.
Ctrl+CClear the draft or exit when the draft is empty.