a2a¶
Discover, message, and manage A2A agents from your terminal.
Pick the agent with --agent-card (a host, a card URL or a card file) or --endpoint with --transport. Every flag can also come from an A2ACLI_* environment variable or a config file; a2a config show prints where each value came from.
Commands¶
| Command | Description |
|---|---|
auth |
Manage the credentials sent to agents |
card |
Work with agent cards |
catalog |
Work with AI Catalogs of agents (experimental) |
chat |
Chat interactively with an agent |
completion |
Generate the autocompletion script for the specified shell |
config |
Inspect configuration |
contact |
Manage the contact book of trusted agents |
plugin |
Work with command plugins |
send |
Send a message to an agent |
skill |
Print the a2a-cli agent skill |
task |
Work with tasks |
transport |
Work with transport plugins |
version |
Print version information |
Global flags¶
Every command takes these.
| Flag | Default | Description |
|---|---|---|
--a2a-version string |
Controls which a2a-protocol version client will advertise to the server. | |
-a, --agent-card host|url|path |
Agent Card reference: host/origin, full card URL, local file path, an AI Catalog entry identifier, or a contact name | |
--auth string |
Shorthand for --svc-param Authorization=<creds> | |
--ca-cert string |
Trust only the CA certificates in this PEM file for TLS connections | |
--catalog string |
AI Catalog to resolve --agent-card in: a registered catalog name, or a catalog URL (experimental) | |
--config string |
Load configuration from an explicit file (.yaml, .json, or .env) in place of the local .env | |
--credential-helper helper |
Credential helper returning the headers for an agent: [scope=]path (repeatable; see a2a auth get --help) | |
-e, --endpoint string |
Agent interface URL for a direct connection; skips card resolution and requires a single --transport flag | |
--insecure |
Use insecure (plaintext) gRPC transport credentials | |
-o, --output string |
text |
Output format: text, json (indented), or jsonl (one compact JSON object per line) |
--svc-param key=value |
Service parameter key=value (repeatable) | |
--tenant string |
Tenant identifier | |
--timeout duration |
30s |
Request timeout |
--transport stringArray |
Transport preference: rest, jsonrpc, grpc, or an installed plugin name (repeatable, highest preference first) | |
--unix-socket string |
Send every HTTP request and gRPC connection through the Unix socket at this path | |
-v, --verbose |
Verbose output to stderr |