a2a is the official command-line client for A2A (Agent2Agent) agents, and the a2a-cli plugin teaches coding agents such as Claude Code, Codex and Gemini CLI to use it. With it, you or your coding agent can discover agents, send them messages and files, stream their replies and manage their tasks over JSON-RPC, REST, gRPC or a transport you plug in.
- Give it to your coding agent: install the a2a-cli plugin from the a2aproject/agent-plugins marketplace.
- Talk to any agent: find it in an AI Catalog, read its agent card, send text, files and data, stream replies and hold conversations.
- Script it: JSON output and distinct exit codes, async tasks and push notifications.
- Fit it to your setup: configuration from flags, variables and files, credential helpers, and plugins for new commands and transports.
Built on A2A Protocol v1.0, and speaks v0.3 too.
Install on macOS or Linux:
brew tap a2aproject/a2a-cli https://github.com/a2aproject/a2a-cli
brew install a2aOn Windows, winget install a2aproject.a2acli. Getting Started lists the other ways, including an install script and go install.
The plugin runs the a2a binary, so install that first. Then add the plugin to your coding agent. In Claude Code:
/plugin marketplace add a2aproject/agent-plugins
/plugin install a2a-cli@a2a-pluginsIn Claude Code the plugin also tells the agent about your contacts, and about A2A agents found on sites that come up in the conversation; see Contacts and agent discovery. Coding agents has the commands for Copilot CLI, Codex, Gemini CLI, OpenCode and others. The plugin carries the a2a-cli skill, which npx skills add https://github.com/a2aproject/a2a-cli --skill a2a-cli also installs on its own.
a2a card get https://agent.example.com # what can it do?
a2a send -a https://agent.example.com "Summarize this" # ask and wait
a2a send -a https://agent.example.com --stream "..." # watch it workNo agent yet? a2a-serve serves Claude Code, opencode or any ACP coding agent as an A2A agent. Getting Started sets one up.
The full documentation is at a2aproject.github.io/a2a-cli.
| Section | For |
|---|---|
| User Guide | A short page on each task. |
| Lessons | A recorded, step-by-step course from your first message to credentials. |
| Examples | Recipes to copy: scripting with jq, a credential helper, plugins. |
| Advanced | How discovery, streaming, credential helpers and plugins work inside. |
| Reference | Every command, flag, configuration key, output format and exit code. |
We welcome issues and pull requests. Read the Contributing guide to get started, and tell us how you use the tool on the Discord server.
This project reconciles the community and SDK A2A CLIs into one standard client, and builds on the CLI from the A2A Go SDK.
The A2A CLI is licensed under the Apache License 2.0.
