The A2A CLI (a2a) is an official tool developed and maintained by the A2A Project Team.
The A2A CLI (a2a) is a standardized command-line client for discovering, interacting with, and managing A2A (Agent2Agent) agents.
Important
Specification in Active Review (v0.2)
We are formalizing and reviewing the A2A CLI Specification. Share feedback, questions, and contributions on the specification documents as we finalize v0.2 in August 2026.
Several community-driven CLI tools exist across languages, but they vary in coverage and behavior. To prevent fragmentation, this project defines one standardized, officially supported CLI specification and reference implementation — built for long-term stability, cross-transport consistency, and community alignment.
The initial codebase builds on the CLI from the A2A Go SDK. We will refine and expand it to match the finalized specification.
The specification is a standalone document that defines the CLI behavior, command surface, output schemas, and transport rules for a2a-cli:
- Specification Document (v0.2): The normative behavior specification covering command taxonomy, output contracts, polling/streaming rules, and exit codes.
- Compliance Model (v0.2): The requirement registry and verification model for claiming conformance.
- Compliance Report Template: The standardized machine-readable report for implementations.
The specification organizes CLI capabilities into three cumulative tiers. We will build and ship them in order:
- Tier 1 (Core Requirements): Essential foundation — agent card discovery (
discover), basic messaging (send), task inspection (get task), cancellation (cancel), polling, exit codes, and standard text/JSON output contracts. - Tier 2 (Standard Features): Expanded capabilities — task listing (
list tasks), real-time event streaming (subscribe), transport auto-negotiation (REST, JSON-RPC, gRPC), push-configuration, and auth management. - Tier 3 (Advanced & Ergonomics): Advanced tooling — interactive terminal chat, push-notification webhook receivers, extended card verification, and mTLS / OpenID Connect authentication.
We invite review and input from engineers and the broader community:
- Read the Specification Document (
SPEC.md). - Review the Compliance Checklist (
COMPLIANCE.md). - Open an issue or pull request in this repository to share suggestions, questions, or edge cases.
You can also help us in other ways like sharing how you use the tool. See the Contributing guide to get started.
The A2A CLI and Specification are open-source and licensed under the Apache License 2.0.