Skip to content

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