google-agents-cli 0.1.1

Agents CLI — Agent Development Lifecycle toolchain for ADK

agents-cli

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

Get Started   |   Skills   |   Commands   |   PyPI   |   Issues   |   Docs   |   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: Gemini CLI  •  Claude Code  •  Codex  •  Antigravity  •  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 Gemini 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, evalsets, LLM-as-judge, trajectory scoring
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 run	Run agent evaluations
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 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 run	Run agent evaluations
agents-cli eval compare	Compare two eval result files
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 Gemini 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.

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 [e-mail] 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. The CLI is distributed as a pre-built wheel rather than as source in the repository, which lets us iterate quickly while keeping the public interface stable. The code is not obfuscated — you can inspect any release by extracting the .whl file (a standard zip archive).

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.

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.