google-agents-cli

✓ Official★ 4,749

Claude Code plugin · google/agents-cli · Apache-2.0

Scaffold, develop, evaluate, and deploy AI agents with Google ADK. Bundles 7 skills for the agent development lifecycle.

7 skills — installs as one unit

View on GitHub

⌁ skills (7)

google-agents-cli-adk-code

🔥🔥🔥🔥✓ Verified

This 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 suite. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, and state management. Do NOT use for creating new projects (use google-agents-cli-scaffold) or deployment...

Full instructions & audit →

google-agents-cli-deploy

🔥🔥🔥✓ Verified

This 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. Covers deployment workflows, service accounts, rollback, and production infrastructure. Part of the Google ADK (Agent Development Kit) skills suite. Do NOT use for API code patterns (use google-agents-cli-adk-code), evaluation (use google-agents-cli-eval), or...

Full instructions & audit →

google-agents-cli-eval

🔥🔥🔥✓ Verified

This 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 eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Do NOT use for API code patterns (use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use...

Full instructions & audit →

google-agents-cli-observability

🔥🔥🔥✓ Verified

This 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 logging, BigQuery Agent Analytics, third-party integrations (AgentOps, Phoenix, MLflow, etc.), and troubleshooting. Part of the Google ADK (Agent Development Kit) skills suite. Do NOT use for deployment setup (use...

Full instructions & audit →

google-agents-cli-publish

🔥🔥🔥✓ Verified

This 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. Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, and troubleshooting. Part of the Google ADK (Agent Development Kit) skills suite. Do NOT use for deployment (use...

Full instructions & audit →

google-agents-cli-scaffold

🔥🔥🔥✓ Verified

This 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. Covers `agents-cli scaffold create`, `scaffold enhance`, and `scaffold upgrade` commands, template options, deployment targets, and the prototype-first workflow. Do NOT use for writing agent code (use...

Full instructions & audit →

google-agents-cli-workflow

🔥🔥🔥🔥✓ Verified

This skill should be used when the user wants to "develop an agent", "build an agent using ADK", "run the agent locally", "debug agent code", "test an agent", "deploy an agent", "publish an agent", "monitor an agent", or needs the ADK (Agent Development Kit) development lifecycle and coding guidelines. Entrypoint for building ADK agents. Always active — provides the full workflow (scaffold, build, evaluate, deploy, publish, observe), code preservation rules, model selection guidance, and...

Full instructions & audit →

<div align="center"> <img src="https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/logo_sm.png" alt="agents-cli logo" width="120" /> <h1><code>agents-cli</code></h1> <p>The CLI and skills for building agents on Gemini Enterprise Agent Platform.</p> <p> <a href="#get-started">Get Started</a>   |   <a href="#agent-skills">Skills</a>   |   <a href="#cli-commands">Commands</a>   |   <a href="https://pypi.org/project/google-agents-cli/">PyPI</a>   |   <a href="https://github.com/google/agents-cli/issues">Issues</a>   |   <a href="https://google.github.io/agents-cli/">Docs</a>   |   <a href="https://github.com/google/agents-cli/blob/main/RELEASE_NOTES.md">Release Notes</a>   |   <a href="https://github.com/google/agents-cli/stargazers">Star us</a> </p> </div>

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

<details> <summary>Or just the skills — your coding agent will handle the rest</summary>

npx skills add google/agents-cli

</details>

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

<details> <summary>See all commands</summary>

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

</details>

How it works

Architecture

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

Architecture

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 <a href="mailto:agents-cli@google.com">agents-cli@google.com</a> to share your agent or provide feedback

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.

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

FAQ

Is this an alternative to Antigravity CLI, Claude Code, or Codex?<br> 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?<br> 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?<br> 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?<br> Yes. agents-cli scaffold enhance adds deployment and CI/CD to existing projects.

Can I use agents-cli without a coding agent?<br> 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?<br> 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).

In Claude Code, add the marketplace and install:

Copy & paste — that's it

/plugin marketplace add google/agents-cli

Copy & paste — that's it

/plugin install google-agents-cli

One install gets you everything — 7 skills — kept up to date together.