> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aion.to/llms.txt
> Use this file to discover all available pages before exploring further.

# aion chat

> Interactive CLI chat against an A2A endpoint.

<img src="https://mintcdn.com/terminalresearch/onVinGXaRwnoau8e/assets/why-use-aion/tools/aion-cli.png?fit=max&auto=format&n=onVinGXaRwnoau8e&q=85&s=db47b1f4634ebbff1cc39c8e4bb95928" alt="Aion Chat terminal interface" width="2142" height="1020" data-path="assets/why-use-aion/tools/aion-cli.png" />

`aion chat` opens the Aion terminal chat interface from the Python SDK CLI. Use it to test an
A2A-compatible agent from a local project or through an Aion proxy.

By default, `aion chat` connects to `http://localhost:8000`.

## Usage

```bash theme={null}
aion chat [OPTIONS]
```

## Options

| Option                    | Description                                                      |
| ------------------------- | ---------------------------------------------------------------- |
| `--url`, `--host`, `-u`   | Agent or proxy URL. Default `http://localhost:8000`.             |
| `--agent-id`              | Agent identifier for proxy-aware routing.                        |
| `--token`                 | Bearer token for authenticated endpoints.                        |
| `--header`                | Custom HTTP header in `key=value` format. Can be repeated.       |
| `--push-notifications`    | Enable the local push notification receiver.                     |
| `--no-push-notifications` | Disable push notifications.                                      |
| `--push-receiver`         | Push notification receiver URL. Default `http://localhost:5000`. |
| `--help`                  | Show command help.                                               |

## Examples

```bash theme={null}
# Basic local chat
aion chat

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

# Connect to a deployed endpoint
aion chat --url https://agent.example.com

# Send custom headers
aion chat --header "X-Client=aion-cli"

# Send a bearer token
aion chat --token "$AION_TOKEN"

# Enable push notifications
aion chat --push-notifications --push-receiver http://localhost:5000

# Show command help
aion chat --help
```

Use `aion --version` to print the Python SDK CLI version.

## Standalone Install

You can also install the chat interface as a standalone npm package:

```bash theme={null}
npm install -g @terminal-research/aion
aio --url http://localhost:8000
```

See [Aion Chat](/tools/aion-chat) for standalone installation and usage.