6.4k GitHub stars and counting — google/agents-cli is a Python project TopGit is tracking across repositories on the platform. The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
The CLI and skills for building agents on Gemini 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 Gemini 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
Create a new agent project with defaults (adk_python template, agent_runtime target)
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
Register with Gemini
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> -y
Create a new agent project with defaults (adk_python template, agent_runtime target)
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
Register with Gemini
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:
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). genai-factory has Terraform blueprints for enterprise GenAI infrastructure and ships as an extension: agents-cli extension add GoogleCloudPlatform/genai-factory.
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 [email protected] 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.
Telemetry
By default, agents-cli emits a single usage signal per command invocation to help
improve the tool and better understand how it's used. Each signal
is a structured log entry written to your own Google Cloud project:
GOOGLE_CLOUD_PROJECT, or else the default project of your Application Default
Credentials (logName=projects/<project>/logs/agents-cli), where you can query
it in Cloud Logging. It records only the metadata such as command name
(e.g. deploy, scaffold.create), exit code, error class, duration (measured
from command dispatch to exit, so it excludes CLI startup), CLI/Python versions,
and OS — never file contents, arguments, or other input. Commands added by
extensions are recorded without their names. A command an extension serves is
marked as such, and the extension is named only if it was installed from a
repository in the google GitHub organization.
The request that writes the entry also carries usage metadata in its
User-Agent and X-Goog-Api-Client headers, which Google receives for
agents-cli usage analytics: the CLI and Python versions, the OS and its release,
the CPU architecture, the command name and a random per-invocation ID. The log
entry's contents, such as the exit code, error class and duration, stay in your
project.
To opt out of sending telemetry, use one of the following environment variables:
# our cli-specific variable
# 0, false, no, or off (case-insensitive):
export AGENTS_CLI_TELEMETRY=0
# donottrack.sh standard variable
export DO_NOT_TRACK=1
Use agents-cli info to see the current telemetry state.
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.
The most recent commit recorded on google/agents-cli was 4 months ago, based on the GitHub push timestamp. The repository has 734 forks — one of the better signals of community interest.
How many stars does google/agents-cli have?
google/agents-cli has 6.4k GitHub stars — refresh the page for the live number, or check github.com/google/agents-cli. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is google/agents-cli written in?
google/agents-cli is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
What license does google/agents-cli use?
google/agents-cli is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is google/agents-cli associated with?
GitHub's repository topics for google/agents-cli: "adk", "agent-development-kit", "agents", "coding-agent", "gemini", "gemini-enterprise-agent-platform", "generative-ai", "google-cloud". TopGit's editorial category is AI Tools.
Where can I see google/agents-cli in action?
The project maintains a homepage at https://google.github.io/agents-cli/. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about google/agents-cli?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/google/agents-cli is the definitive source.
Read full README in the tab above.
Curious whether agents-cli is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about agents-cli.