`agents-cli`

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

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

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.

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.

Metadata

Release files for google-agents-cli 1.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for google-agents-cli 1.7.0
File	Size	Uploaded
google_agents_cli-1.7.0.tar.gz	1.1 MB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for google-agents-cli 1.7.0
File	Interpreter	ABI	Platform	Reset
google_agents_cli-1.7.0-py3-none-any.whl 1.4 MB Sep 22, 2026	Python 3	none	any	Details

Total release size: 2.5 MB

Release files / google_agents_cli-1.7.0.tar.gz

Download URL	google_agents_cli-1.7.0.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`2dfe60c6abb90495f1140857872d31f5a50a3d4b9a19ba4ab2583d4eef243f96`
BLAKE2b-256 checksum How to use checksums	`56c0cb7ea97c7af4bca85347d66f5128051321e610b217d3663f8ba5925d3b5a`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.2.0 CPython/3.11.2`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: Google Cloud
Publisher account: agents-cli-py@oss-exit-gate-prod.iam.gserviceaccount.com

Workflow

No publishing configuration found

Artifact

Subject: google_agents_cli-1.7.0.tar.gz
SHA-256 checksum: 2dfe60c6abb90495f1140857872d31f5a50a3d4b9a19ba4ab2583d4eef243f96 Verifying attestations

Release files / google_agents_cli-1.7.0-py3-none-any.whl

Download URL	google_agents_cli-1.7.0-py3-none-any.whl
Size	1.4 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`44b2570230b6493f9c24adb2764468ac179fdcb7c556709f12169e50dadb2bd9`
BLAKE2b-256 checksum How to use checksums	`a590c15c9d13404abad2dcdb7e647fddca6dbf80f95e3fe8ee9a6000036a3f6d`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.2.0 CPython/3.11.2`

Provenance

Identity

Publishing platform: Google Cloud
Publisher account: agents-cli-py@oss-exit-gate-prod.iam.gserviceaccount.com

Workflow

No publishing configuration found

Artifact

Subject: google_agents_cli-1.7.0-py3-none-any.whl
SHA-256 checksum: 44b2570230b6493f9c24adb2764468ac179fdcb7c556709f12169e50dadb2bd9 Verifying attestations