google-agents-cli 0.5.0__tar.gz

google_agents_cli-0.5.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

google_agents_cli-0.5.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: google-agents-cli
+Version: 0.5.0
+Summary: Agents CLI — Agent Development Lifecycle toolchain for ADK
+Author-email: Google LLC <agents-cli-dev-pypi@google.com>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-Expression: Apache-2.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+Requires-Dist: click>=8.1.8,<9
+Requires-Dist: PyYAML>=6.0.2,<7
+Requires-Dist: cookiecutter>=2.6.0,<3
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: google-cloud-aiplatform[evaluation]>=1.156.0
+Requires-Dist: google-cloud-resource-manager>=1.12.0
+Requires-Dist: google-auth[pyopenssl]>=2.47.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: backoff>=2.2.1
+Requires-Dist: requests>=2.31.0
+Requires-Dist: a2a-sdk~=0.3.22
+Requires-Dist: tomlkit>=0.13.0,<1
+Requires-Dist: ruff ; extra == "lint"
+Requires-Dist: ty ; extra == "lint"
+Requires-Dist: codespell ; extra == "lint"
+Project-URL: documentation, https://google.github.io/agents-cli/
+Project-URL: homepage, https://github.com/google/agents-cli
+Project-URL: issues, https://github.com/google/agents-cli/issues
+Project-URL: releasenotes, https://github.com/google/agents-cli/blob/main/RELEASE_NOTES.md
+Provides-Extra: lint
+
+<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> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="#agent-skills">Skills</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="#cli-commands">Commands</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://pypi.org/project/google-agents-cli/">PyPI</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://github.com/google/agents-cli/issues">Issues</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://google.github.io/agents-cli/">Docs</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://github.com/google/agents-cli/blob/main/RELEASE_NOTES.md">Release Notes</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <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:**
+[Gemini CLI](https://github.com/google-gemini/gemini-cli) &nbsp;•&nbsp; [Claude Code](https://docs.anthropic.com/en/docs/claude-code) &nbsp;•&nbsp; [Codex](https://github.com/openai/codex) &nbsp;•&nbsp; [Antigravity](https://antigravity.google/) &nbsp;•&nbsp; *and any other coding agent.*
+
+## Get Started
+
+**Prerequisites:** Python 3.11+, [uv](https://docs.astral.sh/uv/getting-started/installation/), and [Node.js](https://nodejs.org/en/download).
+
+### 1. Install
+
+```bash
+uvx google-agents-cli setup
+```
+
+<details>
+<summary>Or just the skills — your coding agent will handle the rest</summary>
+
+```bash
+npx skills add google/agents-cli
+```
+
+</details>
+
+### 2. Open your coding agent
+
+Launch [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/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](https://google.github.io/agents-cli/guide/quickstart-tutorial/) for a step-by-step walkthrough.
+
+**[Browse the full documentation →](https://google.github.io/agents-cli/)**
+
+---
+
+## 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](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 |
+| `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
+
+<div align="center">
+  <a href="https://youtu.be/ECYKo70pPNc">
+    <img src="https://img.youtube.com/vi/ECYKo70pPNc/maxresdefault.jpg" alt="agents-cli demo video" width="100%" />
+  </a>
+</div>
+
+---
+
+## Architecture
+
+The Google Cloud agent stack that `agents-cli` builds on:
+
+![Architecture](https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/architecture.png "Architecture")
+
+## FAQ
+
+**Is this an alternative to Gemini 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](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.
+
+**Do I need Google Cloud?**<br>
+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.
+
+**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](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).
+
+## Feedback
+
+We value your input — it helps us improve `agents-cli` for the community.
+
+- **Bugs & feature requests:** [open an issue](https://github.com/google/agents-cli/issues/new) — 👍 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
+
+## Contributing
+
+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. 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](CONTRIBUTING.md) 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](https://cloud.google.com/terms/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](https://cloud.google.com/terms/service-terms#1).
+Pre-GA features are available "as is" and might have limited support. For more
+information, see the
+[launch stage descriptions](https://cloud.google.com/products?hl=en#product-launch-stages).
+

google_agents_cli-0.5.0/README.md

@@ -0,0 +1,182 @@
+<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> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="#agent-skills">Skills</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="#cli-commands">Commands</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://pypi.org/project/google-agents-cli/">PyPI</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://github.com/google/agents-cli/issues">Issues</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://google.github.io/agents-cli/">Docs</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <a href="https://github.com/google/agents-cli/blob/main/RELEASE_NOTES.md">Release Notes</a> &nbsp;&nbsp;|&nbsp;&nbsp;
+    <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:**
+[Gemini CLI](https://github.com/google-gemini/gemini-cli) &nbsp;•&nbsp; [Claude Code](https://docs.anthropic.com/en/docs/claude-code) &nbsp;•&nbsp; [Codex](https://github.com/openai/codex) &nbsp;•&nbsp; [Antigravity](https://antigravity.google/) &nbsp;•&nbsp; *and any other coding agent.*
+
+## Get Started
+
+**Prerequisites:** Python 3.11+, [uv](https://docs.astral.sh/uv/getting-started/installation/), and [Node.js](https://nodejs.org/en/download).
+
+### 1. Install
+
+```bash
+uvx google-agents-cli setup
+```
+
+<details>
+<summary>Or just the skills — your coding agent will handle the rest</summary>
+
+```bash
+npx skills add google/agents-cli
+```
+
+</details>
+
+### 2. Open your coding agent
+
+Launch [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/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](https://google.github.io/agents-cli/guide/quickstart-tutorial/) for a step-by-step walkthrough.
+
+**[Browse the full documentation →](https://google.github.io/agents-cli/)**
+
+---
+
+## 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](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 |
+| `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
+
+<div align="center">
+  <a href="https://youtu.be/ECYKo70pPNc">
+    <img src="https://img.youtube.com/vi/ECYKo70pPNc/maxresdefault.jpg" alt="agents-cli demo video" width="100%" />
+  </a>
+</div>
+
+---
+
+## Architecture
+
+The Google Cloud agent stack that `agents-cli` builds on:
+
+![Architecture](https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/architecture.png "Architecture")
+
+## FAQ
+
+**Is this an alternative to Gemini 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](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.
+
+**Do I need Google Cloud?**<br>
+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.
+
+**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](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).
+
+## Feedback
+
+We value your input — it helps us improve `agents-cli` for the community.
+
+- **Bugs & feature requests:** [open an issue](https://github.com/google/agents-cli/issues/new) — 👍 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
+
+## Contributing
+
+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. 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](CONTRIBUTING.md) 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](https://cloud.google.com/terms/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](https://cloud.google.com/terms/service-terms#1).
+Pre-GA features are available "as is" and might have limited support. For more
+information, see the
+[launch stage descriptions](https://cloud.google.com/products?hl=en#product-launch-stages).