agents-cli README

The project's README from github.com/google/agents-cli. As one markdown file: README.md.

agents-cli logo

agents-cli

The CLI and skills for building agents on Gemini Enterprise Agent Platform.

Get Started   |   Skills   |   Commands   |   PyPI   |   Issues   |   Docs   |   Release Notes   |   Star us

Turn your favorite coding assistant into an expert at building and deploying agents on Google Cloud.

Agents CLI in Agent Platform (agents-cli) gives your coding agent the skills and commands to build, scale, govern, and optimize enterprise-grade agents — so you don't have to learn every CLI and service yourself.

Works seamlessly with: Antigravity CLI  •  Claude Code  •  Codex  •  and any other coding agent.

Get Started

Prerequisites: Python 3.11+, uv, and Node.js.

1. Install

uvx google-agents-cli setup
Or just the skills — your coding agent will handle the rest 
npx skills add google/agents-cli

2. Open your coding agent

Launch Antigravity CLI, Claude Code, Codex, or any coding agent you prefer.

3. Build your first agent

Ask your coding agent to build something — e.g. "Use agents-cli to build a caveman-style agent that compresses verbose text into terse, technical grunts"

See the full tutorial for a step-by-step walkthrough.

Browse the full documentation →

Agent Skills

Skill What your coding agent learns
google-agents-cli-workflow Development lifecycle, code preservation rules, model selection
google-agents-cli-adk-code ADK Python API — agents, tools, orchestration, callbacks, state
google-agents-cli-scaffold Project scaffolding — create, enhance, upgrade
google-agents-cli-eval Evaluation methodology — metrics, datasets, LLM-as-judge, adaptive rubrics
google-agents-cli-deploy Deployment — Agent Runtime, Cloud Run, GKE, CI/CD, secrets
google-agents-cli-publish Gemini Enterprise registration
google-agents-cli-observability Observability — Cloud Trace, logging, third-party integrations

CLI Commands

Command What it does
agents-cli setup Install CLI + skills to coding agents
agents-cli create <name> Create a new agent project
agents-cli eval run Run the agent over the eval dataset and grade the traces
agents-cli deploy Deploy to Google Cloud
agents-cli publish gemini-enterprise Register with Gemini Enterprise
See all commands
Command Description
agents-cli login Authenticate with Google Cloud or AI Studio
agents-cli login --status Show authentication status
Scaffold
agents-cli create <name> Create a new agent project
agents-cli scaffold enhance Add deployment or CI/CD to an existing project
agents-cli scaffold upgrade Upgrade project to a newer agents-cli version
Develop
agents-cli run "prompt" Run agent with a single prompt
agents-cli install Install project dependencies
agents-cli lint Run code quality checks (Ruff)
Evaluate
agents-cli eval run Run agent inference and grade the traces
agents-cli eval generate Run agent inference over eval cases
agents-cli eval grade Grade generated traces against metrics
agents-cli eval dataset synthesize Synthesize multi-turn eval scenarios for your local agent
agents-cli eval compare Compare two eval result files
agents-cli eval analyze Cluster failure modes from grade results
agents-cli eval metric list List available metrics
agents-cli eval optimize Auto-tune agent prompts using eval data
Deploy & Publish
agents-cli deploy Deploy to Google Cloud
agents-cli publish gemini-enterprise Register with Gemini Enterprise
agents-cli infra single-project Provision single-project infrastructure
agents-cli infra cicd Set up CI/CD pipeline + staging/prod infrastructure
Other
agents-cli info Show project config and CLI version
agents-cli update Force reinstall skills to all IDEs

How it works

agents-cli demo video

Architecture

The Google Cloud agent stack that agents-cli builds on:

Architecture

FAQ

Is this an alternative to Antigravity CLI, Claude Code, or Codex?
No. agents-cli is a tool for coding agents, not a coding agent itself. It provides the CLI commands and skills that make your coding agent better at building, evaluating, and deploying ADK agents on Google Cloud.

How is this different from just using adk directly?
ADK is an agent framework. agents-cli gives your coding agent the skills and tools to build, evaluate, and deploy ADK agents end-to-end.

Do I need Google Cloud?
For local development (create, run, eval), no — you can use an AI Studio API key to run Gemini with ADK locally. For deployment and cloud features, yes.

Can I use this with an existing agent project?
Yes. agents-cli scaffold enhance adds deployment and CI/CD to existing projects.

Can I use agents-cli without a coding agent?
Yes. The CLI works standalone — you can run agents-cli scaffold, eval, deploy, and every other command directly from your terminal. The skills just make it easier for coding agents to do it for you.

How can I extend agents-cli with other skills?
agents-cli skills cover the agent-building lifecycle (scaffold, ADK code patterns, evals, deploy, publish, observability). For adjacent concerns, you could install another skill suite alongside. For example, agent-skills covers general software-engineering workflows (ideation, spec gates, planning, code review), and google/skills covers Google Cloud foundations (BigQuery, Cloud Run, Firebase, GKE).

Feedback

We value your input — it helps us improve agents-cli for the community.

Contributing

The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via issues to directly shape our roadmap.

See the contributing guide for details.

Terms of Service

agents-cli leverages Google Cloud APIs. When you deploy agents, you'll be deploying resources in your own Google Cloud project and will be responsible for those resources. Please review the Google Cloud Service Terms for details.

agents-cli (google/agents-cli)

Searching Database…

6.1K ·GitHub
Agents-cli
Что это такое?agents-cli даёт вашему ассистенту для программирования (Claude Code, Codex, Antigravity CLI и др.) команды CLI и файлы навыков, которые нужны ему для создания, оценки и развёртывания ИИ-агентов в Google Cloud с помощью Agent Development Kit (ADK).
Является ли agents-cli сам ассистентом для программирования или он работает с другими ассистентами?Нет, это не ассистент для программирования. Это CLI и набор файлов навыков, которые подключаются к уже существующему ассистенту, например Claude Code, Codex или Antigravity CLI, и учат его создавать каркас, оценивать и развёртывать агентов ADK.
Как это запустить?Установите CLI (или только файлы навыков), откройте нужного вам ассистента для программирования и попросите его что-нибудь создать; навыки проведут ваш ассистент через создание каркаса, запуск и развёртывание проекта.
Что нужно установить перед настройкой?Перед выполнением шага установки нужно установить Python 3.11+, uv и Node.js.
Нужна ли учётная запись Google Cloud, чтобы пользоваться этим?Для локальной работы — нет: для создания, запуска и оценки агентов достаточно ключа API AI Studio. Реальный проект Google Cloud понадобится, когда вы захотите развернуть агентов или использовать облачные возможности, например Agent Runtime или Cloud Run.
С какими ассистентами для программирования работает agents-cli?Он создан для работы с Antigravity CLI, Claude Code и Codex, а также, в принципе, с любым другим ассистентом для программирования, который умеет читать его файлы навыков.
Чем это отличается от прямого использования ADK?ADK — это базовый фреймворк для агентов; agents-cli добавляет команды CLI и навыки, которые позволяют вашему ассистенту создавать каркас, оценивать и развёртывать агентов ADK от начала до конца, без необходимости самому изучать все API ADK и сервисы GCP.
Можно ли добавить agents-cli в существующий проект агента?Да, команда 'agents-cli scaffold enhance' добавляет развёртывание и настройку CI/CD в уже существующий проект.
Что именно проверяет система оценки?Она запускает вашего агента на наборе данных для оценки, оценивает полученные трассировки с помощью метрик LLM-as-judge и адаптивных рубрик, а также может автоматически настраивать промпты или группировать типичные виды сбоев по результатам.
What are similar projects?foreman, opensre, adk-python, openrig, voltagent, agento11y, open-multi-agent, ruflo
Which topics is it in?agent-evaluation, agent-observability, google-cloud, gcp, toolkit, deployment, agent-skill, google, agent-framework, coding-agents, evaluation, enterprise
Creator
google
Size
12.1 MB
Stars
6.1K
Updated
CommitOct 12Releasev1.10.0Oct 12
Age
6mo
Commits · 90 Days