A2A CLI
Консольный клиент протокола A2A: читает карточки удаленных агентов, шлет им сообщения и следит за задачами из терминала.
- 184 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- CLI ходит по сети к указанным удаленным агентам и отправляет им текст сообщений и файлы.
- Сообщения уходят чужому агенту, который сам решает, как их обработать.
Установка
- Работает в
Ручная установка
brew tap a2aproject/a2a-cli https://github.com/a2aproject/a2a-cli && brew install a2aДве команды Homebrew ставят бинарный файл `a2a` для macOS и Linux.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI ходит по сети к указанным удаленным агентам и отправляет им текст сообщений и файлы.
- Сообщения уходят чужому агенту, который сам решает, как их обработать.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `a2a` — официальный клиент протокола Agent2Agent от команды A2A Project. Она запрашивает у удаленного агента его карточку с описанием возможностей, отправляет сообщение и возвращает результат. Ответ можно получить потоком событий или асинхронно: тогда задачу опрашивают по идентификатору до завершения. Вывод выдается в JSON, коды возврата предсказуемы, поэтому CLI встраивается в скрипты и конвейеры. Поддержаны транспорты JSON-RPC, REST и gRPC, дополнительные подключаются бинарным файлом `a2a-transport-<имя>` в `PATH` без пересборки. Режим `--exec` превращает обычный скрипт в A2A-сервер. В репозитории лежит скилл `a2a-cli` для Claude Code, Cursor и Codex: он учит агента делегировать работу удаленным A2A-агентам через эту команду.
Для кого. Разработчикам мультиагентных систем на A2A, которым нужно проверять чужих агентов руками и передавать им задачи из кодинг-агента.
Подходит, если
- Агент в вашей сети опубликован по A2A, и нужно быстро посмотреть его карточку с навыками.
- Кодинг-агент должен передать часть работы удаленному агенту и дождаться результата.
- Скрипт на shell или Python надо выставить как A2A-сервер, не пиша серверный код.
- В пайплайне CI проверяют ответ A2A-агента по JSON-выводу и коду возврата.
Не подходит, если
- Нужен клиент для протоколов вне A2A, например для MCP.
- Нужна готовая библиотека для встраивания клиента в приложение на Python или JavaScript.
- Удаленного A2A-агента, к которому есть доступ, нет.
Пример запроса к агенту
Получи карточку агента по адресу https://agent.example.com и отправь ему сообщение с вопросом, что он умеет.Ограничения
CLI только клиентская сторона: без доступного A2A-агента делать нечего, кроме режима `--exec`. Скилл и плагин вызывают бинарный файл `a2a`, поэтому CLI надо поставить заранее. Ответственность за аутентификацию к удаленному агенту лежит на вас: настройки задают флагами, переменными окружения или файлами `.env`. Спецификация протокола v1.0, возможности удаленного агента зависят от его реализации. Установка скриптом `install.sh` кладет файл в `/usr/local/bin`, для другого каталога задайте `A2A_INSTALL_DIR`.
Как отключить. Удалите навык командой менеджера скиллов или плагин через `/plugin`, а бинарный файл `a2a` уберите через `brew uninstall a2a` либо удалением из `PATH`.
Частые вопросы
Как отправить сообщение A2A-агенту?
Выполните `a2a send -a https://agent.example.com "текст"`. Флаг `--stream` включает поток событий, `--async` отправляет задачу без ожидания.
Как дождаться асинхронной задачи?
Командой `a2a task get -a <адрес> <id задачи> --wait --timeout 60s`: она опрашивает задачу до завершения или до таймаута.
Как превратить скрипт в A2A-сервер?
Запустите CLI с флагом `--exec` и путем к скрипту. Пошаговый разбор лежит в первом уроке папки `examples`.
Какие транспорты поддержаны?
JSON-RPC, REST и gRPC встроены. Остальные добавляются отдельным бинарным файлом `a2a-transport-<имя>` в `PATH`.
Нужен ли скилл, если CLI уже установлен?
Для ручной работы нет. Скилл нужен кодинг-агенту: он подсказывает, когда делегировать задачу и какую команду `a2a` запускать.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОдна команда превращает локального агента Claude Code, Codex или Pi в сервер протокола A2A, а Python SDK делает то же для кода.
Скилл для обмена сообщениями между Claude Code, Codex, Gemini CLI и другими консольными агентами через общую локальную базу SQLite на bash
CLI, который держит в одном месте общий контекст кодовых агентов: инструкции, скиллы, MCP, субагентов и долгую память по проектам и машинам
CLI Agent Orchestrator
CLI Agent Orchestrator (CAO)
CLI, который координирует несколько кодовых агентов: супервизор раздает задачи специалистам параллельно или по очереди в отдельных сессиях tmux
Alook дает локальным Claude Code, Codex, Cursor и OpenCode постоянный ник и почтовый ящик, чтобы команда писала им в общих комнатах как людям
Локальная панель для управления множеством агентов на разных машинах: память, граф кода и обмен сообщениями между агентами
Коротко о README
Репозиторий объединяет разрозненные клиенты A2A в один стандартизованный CLI на Go. Он вырос из клиента A2A Go SDK и описан спецификацией с таксономией команд и контрактами вывода. Рядом идут учебные примеры от первого сервера до жизненного цикла задач.