Skip to content
Back to search

google-agents-cli

SkillWorks with Claude CodeOfficial: GoogleGitHub

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/google/agents-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/google/agents-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/google-agents-cli/badge.svg)](/listings/google-agents-cli)

HTML

<a href="/listings/google-agents-cli"><img src="/api/listings/google-agents-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 9 lines
  1. {
  2. "name": "google-agents-cli",
  3. "version": "1.15.0",
  4. "description": "Scaffold, develop, evaluate, and deploy AI agents with Google ADK. Bundles skills for the agent development lifecycle.",
  5. "author": { "name": "Google LLC" },
  6. "homepage": "https://github.com/google/agents-cli",
  7. "repository": "https://github.com/google/agents-cli",
  8. "license": "Apache-2.0"
  9. }
README.md · README · 207 lines
  1. <div align="center">
  2. <img src="https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/logo_sm.png" alt="agents-cli logo" width="120" />
  3. <h1><code>agents-cli</code></h1>
  4. <p>The CLI and skills for building agents on Gemini platform.</p>
  5. <p>
  6. <a href="#get-started">Get Started</a> &nbsp;&nbsp;|&nbsp;&nbsp;
  7. <a href="#agent-skills">Skills</a> &nbsp;&nbsp;|&nbsp;&nbsp;
  8. <a href="#cli-commands">Commands</a> &nbsp;&nbsp;|&nbsp;&nbsp;
  9. <a href="https://pypi.org/project/google-agents-cli/">PyPI</a> &nbsp;&nbsp;|&nbsp;&nbsp;
  10. <a href="https://github.com/google/agents-cli/issues">Issues</a> &nbsp;&nbsp;|&nbsp;&nbsp;
  11. <a href="https://google.github.io/agents-cli/">Docs</a> &nbsp;&nbsp;|&nbsp;&nbsp;
  12. <a href="https://github.com/google/agents-cli/blob/main/RELEASE_NOTES.md">Release Notes</a> &nbsp;&nbsp;|&nbsp;&nbsp;
  13. <a href="https://github.com/google/agents-cli">Star us</a>
  14. </p>
  15. </div>
  16. ---
  17. Turn your favorite coding assistant into an expert at building and deploying agents on Google Cloud.
  18. **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.
  19. **Works seamlessly with:**
  20. [Antigravity CLI](https://antigravity.google/) &nbsp;•&nbsp; [Claude Code](https://docs.anthropic.com/en/docs/claude-code) &nbsp;•&nbsp; [Codex](https://github.com/openai/codex) &nbsp;•&nbsp; *and any other coding agent.*
  21. ## Get Started
  22. **Prerequisites:** Python 3.11+, [uv](https://docs.astral.sh/uv/getting-started/installation/), and [Node.js](https://nodejs.org/en/download).
  23. ### 1. Install
  24. ```bash
  25. uvx google-agents-cli setup
  26. ```
  27. <details>
  28. <summary>Or just the skills — your coding agent will handle the rest</summary>
  29. ```bash
  30. npx skills add google/agents-cli
  31. ```
  32. </details>
  33. ### 2. Open your coding agent
  34. Launch [Antigravity CLI](https://antigravity.google/), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), or any coding agent you prefer.
  35. ### 3. Build your first agent
  36. 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"*
  37. See the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tutorial/) for a step-by-step walkthrough.
  38. **[Browse the full documentation →](https://google.github.io/agents-cli/)**
  39. ---
  40. ## Agent Skills
  41. | Skill | What your coding agent learns |
  42. |-------|-------------------------------|
  43. | `google-agents-cli-workflow` | Development lifecycle, code preservation rules, model selection |
  44. | `google-agents-cli-adk-code` | ADK Python API — agents, tools, orchestration, callbacks, state |
  45. | `google-agents-cli-scaffold` | Project scaffolding — `create`, `enhance`, `upgrade` |
  46. | `google-agents-cli-eval` | Evaluation methodology — metrics, datasets, LLM-as-judge, adaptive rubrics |
  47. | `google-agents-cli-deploy` | Deployment — [Agent Runtime in Gemini platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale), [Cloud Run](https://cloud.google.com/run), [GKE](https://cloud.google.com/kubernetes-engine), CI/CD, secrets |
  48. | `google-agents-cli-publish` | Gemini registration |
  49. | `google-agents-cli-observability` | Observability — Cloud Trace, logging, third-party integrations |
  50. ---
  51. ## CLI Commands
  52. | Command | What it does |
  53. |---------|-------------|
  54. | `agents-cli setup` | Install CLI + skills to coding agents |
  55. | `agents-cli create <name> -y` | Create a new agent project with defaults (`adk_python` template, `agent_runtime` target) |
  56. | `agents-cli eval run` | Run the agent over the eval dataset and grade the traces |
  57. | `agents-cli deploy` | Deploy to Google Cloud |
  58. | `agents-cli publish gemini` | Register with Gemini |
  59. <details>
  60. <summary>See all commands</summary>
  61. | Command | Description |
  62. |---------|-------------|
  63. | `agents-cli login` | Authenticate with Google Cloud or AI Studio |
  64. | `agents-cli login --status` | Show authentication status |
  65. | **Scaffold** | |
  66. | `agents-cli create <name> -y` | Create a new agent project with defaults (`adk_python` template, `agent_runtime` target) |
  67. | `agents-cli scaffold enhance` | Add deployment or CI/CD to an existing project |
  68. | `agents-cli scaffold upgrade` | Upgrade project to a newer agents-cli version |
  69. | **Develop** | |
  70. | `agents-cli run "prompt"` | Run agent with a single prompt |
  71. | `agents-cli install` | Install project dependencies |
  72. | `agents-cli lint` | Run code quality checks (Ruff) |
  73. | **Evaluate** | |
  74. | `agents-cli eval run` | Run agent inference and grade the traces |
  75. | `agents-cli eval generate` | Run agent inference over eval cases |
  76. | `agents-cli eval grade` | Grade generated traces against metrics |
  77. | `agents-cli eval dataset synthesize` | Synthesize multi-turn eval scenarios for your local agent |
  78. | `agents-cli eval compare` | Compare two eval result files |
  79. | `agents-cli eval analyze` | Cluster failure modes from grade results |
  80. | `agents-cli eval metric list` | List available metrics |
  81. | `agents-cli eval optimize` | Auto-tune agent prompts using eval data |
  82. | **Deploy & Publish** | |
  83. | `agents-cli deploy` | Deploy to Google Cloud |
  84. | `agents-cli publish gemini` | Register with Gemini |
  85. | `agents-cli infra single-project` | Provision single-project infrastructure |
  86. | `agents-cli infra cicd` | Set up CI/CD pipeline + staging/prod infrastructure |
  87. | **Other** | |
  88. | `agents-cli info` | Show project config and CLI version |
  89. | `agents-cli update` | Force reinstall skills to all IDEs |
  90. </details>
  91. ## How it works
  92. <div align="center">
  93. <a href="https://youtu.be/ECYKo70pPNc">
  94. <img src="https://img.youtube.com/vi/ECYKo70pPNc/maxresdefault.jpg" alt="agents-cli demo video" width="100%" />
  95. </a>
  96. </div>
  97. ---
  98. ## Architecture
  99. The Google Cloud agent stack that `agents-cli` builds on:
  100. ![Architecture](https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/architecture.png "Architecture")
  101. ## FAQ
  102. **Is this an alternative to Antigravity CLI, Claude Code, or Codex?**<br>
  103. 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.
  104. **How is this different from just using `adk` directly?**<br>
  105. [ADK](https://adk.dev) is an agent framework. `agents-cli` gives your coding agent the skills and tools to build, evaluate, and deploy ADK agents end-to-end.
  106. **Do I need Google Cloud?**<br>
  107. For local development (`create`, `run`, `eval`), no — you can use an [AI Studio API key](https://aistudio.google.com/apikey) to run Gemini with [ADK](https://adk.dev) locally. For deployment and cloud features, yes.
  108. **Can I use this with an existing agent project?**<br>
  109. Yes. `agents-cli scaffold enhance` adds deployment and CI/CD to existing projects.
  110. **Can I use `agents-cli` without a coding agent?**<br>
  111. 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.
  112. **How can I extend `agents-cli` with other skills?**<br>
  113. `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](https://github.com/addyosmani/agent-skills) covers general software-engineering workflows (ideation, spec gates, planning, code review), and [google/skills](https://github.com/google/skills) covers Google Cloud foundations (BigQuery, Cloud Run, Firebase, GKE). [genai-factory](https://github.com/GoogleCloudPlatform/genai-factory) has Terraform blueprints for enterprise GenAI infrastructure and ships as an extension: `agents-cli extension add GoogleCloudPlatform/genai-factory`.
  114. ## Feedback
  115. We value your input — it helps us improve `agents-cli` for the community.
  116. - **Bugs & feature requests:** [open an issue](https://github.com/google/agents-cli/issues/new) — 👍 the ones you want prioritized
  117. - **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
  118. ## Contributing
  119. The best way to contribute is through feedback: bug reports, feature requests, and ideas shared via [issues](https://github.com/google/agents-cli/issues) to directly shape our roadmap.
  120. See the [contributing guide](CONTRIBUTING.md) for details.
  121. ## Telemetry
  122. By default, `agents-cli` emits a single usage signal per command invocation to help
  123. improve the tool and better understand how it's used. Each signal
  124. is a structured log entry written to **your own Google Cloud project**:
  125. `GOOGLE_CLOUD_PROJECT`, or else the default project of your Application Default
  126. Credentials (`logName=projects/<project>/logs/agents-cli`), where you can query
  127. it in Cloud Logging. It records only the metadata such as command name
  128. (e.g. `deploy`, `scaffold.create`), exit code, error class, duration (measured
  129. from command dispatch to exit, so it excludes CLI startup), CLI/Python versions,
  130. and OS — never file contents, arguments, or other input. Commands added by
  131. extensions are recorded without their names. A command an extension serves is
  132. marked as such, and the extension is named only if it was installed from a
  133. repository in the `google` GitHub organization.
  134. The request that writes the entry also carries usage metadata in its
  135. `User-Agent` and `X-Goog-Api-Client` headers, which Google receives for
  136. agents-cli usage analytics: the CLI and Python versions, the OS and its release,
  137. the CPU architecture, the command name and a random per-invocation ID. The log
  138. entry's contents, such as the exit code, error class and duration, stay in your
  139. project.
  140. To opt out of sending telemetry, use one of the following environment variables:
  141. ```bash
  142. # our cli-specific variable
  143. # 0, false, no, or off (case-insensitive):
  144. export AGENTS_CLI_TELEMETRY=0
  145. # donottrack.sh standard variable
  146. export DO_NOT_TRACK=1
  147. ```
  148. Use `agents-cli info` to see the current telemetry state.
  149. ## Terms of Service
  150. `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](https://cloud.google.com/terms/service-terms) for details.

Version history

  • v1.15.011/18/2026

  • v1.14.011/13/2026

  • v1.13.011/5/2026

  • v1.12.010/28/2026

  • v1.11.010/21/2026

  • v1.10.010/18/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.