VerifiedPlugin
Development
google-skills
This repository contains Agent Skills for Google products and technologies, including Google Cloud. This repository is under active development.
104 skills
@googleDevelopment
Plugin
google-agents-cli
The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.
Plugin Signal79/100Solid
maintained97
capable43
documented100
adopted80
Install
$ npx -y skills add google/agents-cli --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
5,527
Stars
590
Forks
Active
Maintenance
Python
Language
Apache-2.0
License
5d ago
Last commit
4mo ago
Created
Repo: google/agents-cli
What's inside
Skills
7/google-agents-cli-adk-codeThis skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management", or needs ADK (Agent Development Kit) Python API patterns and code examples. Part of the Google ADK skills/google-agents-cli-deployThis skill should be used when the user wants to "deploy an agent", "deploy my ADK agent", "set up CI/CD", "configure secrets", "troubleshoot a deployment", or needs guidance on Agent Runtime, Cloud Run, or GKE deployment targets, or awareness of Agent Gateway. Covers deployment/google-agents-cli-evalThis skill should be used when the user wants to "run an evaluation", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Agent Platform eval methodology and the Quality Flywheel. Covers/google-agents-cli-observabilityThis skill should be used when the user wants to "set up tracing", "monitor my ADK agent", "configure logging", "add observability", "debug production traffic", or needs guidance on monitoring deployed ADK (Agent Development Kit) agents. Covers Cloud Trace, prompt-response/google-agents-cli-publishThis skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini Enterprise", "publish to Gemini Enterprise", or needs guidance on the agents-cli publish gemini-enterprise command. Also use when the user wants to "manage/google-agents-cli-scaffoldThis skill should be used when the user wants to "create an agent project", "start a new ADK project", "build me a new agent", "add CI/CD to my project", "add deployment", "enhance my project", or "upgrade my project". Part of the Google ADK (Agent Development Kit) skills suite.
Badges
1
README
1Turn 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
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 scaffold <name> | Create a new agent project |
agents-cli eval generate | Run agent on eval dataset, produce traces |
agents-cli eval grade | Run agent evaluations on the traces |
agents-cli deploy | Deploy to Google Cloud |
agents-cli publish gemini-enterprise | Register with Gemini Enterprise |
| Command | Description |
|---|---|
agents-cli login | Authenticate with Google Cloud or AI Studio |
agents-cli login --status | Show authentication status |
| Scaffold | |
agents-cli scaffold <name> | Create a new agent project |
agents-cli scaffold enhance | Add deployment, CI/CD, or RAG 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 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 |
| Data | |
agents-cli infra datastore | Provision datastore infrastructure for RAG |
agents-cli data-ingestion | Run data ingestion pipeline |
| Other | |
agents-cli info | Show project config and CLI version |
agents-cli update | Force reinstall skills to all IDEs |
How it works
Architecture
The Google Cloud agent stack that agents-cli builds on:
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.
- Bugs & feature requests: open an issue — 👍 the ones you want prioritized
- Share what you built: we'd love to hear about your projects! Reach out at agents-cli@google.com to share your agent or provide feedback
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.
File tree
336google/agents-cliView on GitHub
.claude-plugin/
plugin.json
.github/
ISSUE_TEMPLATE/
bug_report.yml
feature_request.yml
workflows/
docs.yml
CONTRIBUTING.md
docs/
hooks/
skills_reference.py
mkdocs.yml
pyproject.toml
src/
assets/
architecture.png
high_level_architecture.png
logo_sm.png
logos/
antigravity.png
claude.png
gemini.png
openai.svg
observability.png
prototype_to_prod.png
cli/
index.md
guide/
authentication.md
cicd.md
deployment.md
development.md
evaluation.md
getting-started.md
hands-on-tutorial.md
lifecycle.md
observability/
bq-agent-analytics.md
cloud-trace.md
index.md
project-structure.md
quickstart-tutorial.md
templates.md
use-cases.md
index.md
javascripts/
lifecycle.js
persona.js
reference/
about.md
eval-dataset-migration.md
from-agent-starter-pack.md
index.md
skills.md
stylesheets/
custom.css
gemini-extension.json
LICENSE
plugin.json
README.md
RELEASE_NOTES.md
skills/
google-agents-cli-adk-code/
references/
adk-python.md
adk-workflows.md
samples.md
SKILL.md
google-agents-cli-deploy/
references/
agent-runtime.md
batch-inference.md
cicd-pipeline.md
cloud-run.md
gke.md
terraform-patterns.md
testing-deployed-agents.md
SKILL.md
google-agents-cli-eval/
references/
builtin-tools-eval.md
dataset_schema.md
metrics-guide.md
multimodal-eval.md
user-simulation.md
SKILL.md
google-agents-cli-observability/
references/
bigquery-agent-analytics.md
cloud-trace-and-logging.md
SKILL.md
google-agents-cli-publish/
SKILL.md
google-agents-cli-scaffold/
references/
flags.md
SKILL.md
google-agents-cli-workflow/
references/
brainstorming.md
commands.md
internals.md
spec-template.md
terminology.md
SKILL.md
README.md
src/
google/
agents/
cli/
__init__.py
_adk_client.py
_agent_runtime_a2a.py
_click.py
_experiments.py
_gcp_project.py
_output.py
_project.py
_remote.py
_runner.py
_skills_check.py
_tools.py
_trust.py
auth.py
data/
__init__.py
_recipe.py
cmd_data_ingestion.py
deploy/
__init__.py
_operation.py
_utils.py
agent_runtime.py
cmd_deploy.py
dev/
__init__.py
cmd_install.py
cmd_lint.py
cmd_playground.py
eval/
__init__.py
_paths.py
_synthesize_runner.py
cmd_analyze.py
cmd_compare.py
cmd_dataset.py
cmd_eval_group.py
cmd_generate.py
cmd_grade.py
cmd_metric.py
cmd_optimize.py
cmd_run.py
cmd_submit.py
eval_utils.py
optimize_utils.py
info/
__init__.py
cmd_info.py
infra/
__init__.py
_cicd_utils.py
cmd_cicd.py
cmd_datastore.py
cmd_infra_single_project.py
cmd_infra.py
main.py
publish/
__init__.py
cmd_publish_group.py
cmd_publish.py
run/
__init__.py
_local_server.py
_multimodal.py
cmd_run.py
scaffold/
__init__.py
agents/
adk/
adk_go/
.template/
templateconfig.yaml
agent/
agent_test.go
agent.go
adk_java/
.template/
templateconfig.yaml
src/
main/
java/
{{cookiecutter.java_package_path}}/
Agent.java
test/
java/
{{cookiecutter.java_package_path}}/
unit/
AgentTest.java
adk_ts/
.template/
templateconfig.yaml
app/
agent.ts
tests/
integration/
agent.test.ts
.template/
templateconfig.yaml
app/
__init__.py
agent.py
README.md
tests/
eval/
datasets/
basic-dataset.json
README.md
eval_config.yaml
response_quality.py
integration/
test_agent.py
README.md
base_templates/
_shared/
agents-cli-manifest.yaml
deployment/
terraform/
cicd/
apis.tf
build_triggers.tf
github.tf
iam.tf
locals.tf
outputs.tf
providers.tf
service_accounts.tf
storage.tf
variables.tf
vars/
env.tfvars
wif.tf
single-project/
apis.tf
iam.tf
outputs.tf
providers.tf
storage.tf
variables.tf
vars/
env.tfvars
go/
.cloudbuild/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.env.example
.github/
workflows/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.gitignore
.golangci.yml
{{cookiecutter.agent_guidance_filename}}
agent/
agent.go
Dockerfile
e2e/
integration/
server_e2e_test.go
load_test/
.results/
.placeholder
load_test.go
README.md
go.mod
go.sum
main.go
Makefile
README.md
java/
.cloudbuild/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.env.example
.github/
workflows/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.gitignore
{{cookiecutter.agent_guidance_filename}}
Dockerfile
Makefile
pom.xml
README.md
src/
main/
java/
{{cookiecutter.java_package_path}}/
Agent.java
Main.java
resources/
application.properties
test/
java/
{{cookiecutter.java_package_path}}/
e2e/
integration/
ServerE2ETest.java
load_test/
.results/
.placeholder
LoadTest.java
README.md
unit/
AgentTest.java
python/
.cloudbuild/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.env.example
.github/
workflows/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.gitignore
{{cookiecutter.agent_directory}}/
app_utils/
a2a.py
services.py
typing.py
{{cookiecutter.agent_guidance_filename}}
deployment/
terraform/
cicd/
telemetry_outputs.tf
telemetry.tf
shared/
completions.sql
genai_logs_schema.json
single-project/
telemetry_outputs.tf
telemetry.tf
Dockerfile
pyproject.toml
README.md
tests/
unit/
test_dummy.py
typescript/
.cloudbuild/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.dockerignore
.env.example
.github/
workflows/
deploy-to-prod.yaml
pr_checks.yaml
staging.yaml
.gitignore
app/
agent.ts
Dockerfile
eslint.config.mjs
Makefile
package-lock.json
package.json
README.md
tests/
integration/
server_e2e.test.ts
load_test/
.results/
.placeholder
load_test.ts
README.md
unit/
dummy.test.ts
tsconfig.json
vitest.config.ts
cmd_scaffold_group.py
commands/
__init__.py
create.py
enhance.py
upgrade.py
deployment_targets/
agent_runtime/
_shared/
deployment/
deployment_metadata.json
terraform/
cicd/
... 126 moreMore Flows by @google.
@googleFAQ
google-agents-cli is a Claude Code plugin with 7 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes google-agents-cli-adk-code, google-agents-cli-deploy, google-agents-cli-eval. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is google-agents-cli?
- The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.
- How do I install google-agents-cli?
- Run these in Claude Code: npx -y skills add google/agents-cli --agent claude-code. Then prompt normally.
- Does google-agents-cli auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is google-agents-cli free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.