{
  "markdown": "<div align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/logo_sm.png\" alt=\"agents-cli logo\" width=\"120\" />\n  <h1><code>agents-cli</code></h1>\n  <p>The CLI and skills for building agents on Gemini Enterprise Agent Platform.</p>\n\n  <p>\n    <a href=\"#get-started\">Get Started</a> &nbsp;&nbsp;|&nbsp;&nbsp;\n    <a href=\"#agent-skills\">Skills</a> &nbsp;&nbsp;|&nbsp;&nbsp;\n    <a href=\"#cli-commands\">Commands</a> &nbsp;&nbsp;|&nbsp;&nbsp;\n    <a href=\"https://pypi.org/project/google-agents-cli/\">PyPI</a> &nbsp;&nbsp;|&nbsp;&nbsp;\n    <a href=\"https://github.com/google/agents-cli/issues\">Issues</a> &nbsp;&nbsp;|&nbsp;&nbsp;\n    <a href=\"https://google.github.io/agents-cli/\">Docs</a> &nbsp;&nbsp;|&nbsp;&nbsp;\n    <a href=\"https://github.com/google/agents-cli/blob/main/RELEASE_NOTES.md\">Release Notes</a> &nbsp;&nbsp;|&nbsp;&nbsp;\n    <a href=\"https://github.com/google/agents-cli\">Star us</a>\n  </p>\n</div>\n\n---\n\nTurn your favorite coding assistant into an expert at building and deploying agents on Google Cloud.\n\n**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.\n\n**Works seamlessly with:**\n[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.*\n\n## Get Started\n\n**Prerequisites:** Python 3.11+, [uv](https://docs.astral.sh/uv/getting-started/installation/), and [Node.js](https://nodejs.org/en/download).\n\n### 1. Install\n\n```bash\nuvx google-agents-cli setup\n```\n\n<details>\n<summary>Or just the skills — your coding agent will handle the rest</summary>\n\n```bash\nnpx skills add google/agents-cli\n```\n\n</details>\n\n### 2. Open your coding agent\n\nLaunch [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.\n\n### 3. Build your first agent\n\nAsk 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\"*\n\nSee the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tutorial/) for a step-by-step walkthrough.\n\n**[Browse the full documentation →](https://google.github.io/agents-cli/)**\n\n---\n\n## Agent Skills\n\n| Skill | What your coding agent learns |\n|-------|-------------------------------|\n| `google-agents-cli-workflow` | Development lifecycle, code preservation rules, model selection |\n| `google-agents-cli-adk-code` | ADK Python API — agents, tools, orchestration, callbacks, state |\n| `google-agents-cli-scaffold` | Project scaffolding — `create`, `enhance`, `upgrade` |\n| `google-agents-cli-eval` | Evaluation methodology — metrics, datasets, LLM-as-judge, adaptive rubrics |\n| `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 |\n| `google-agents-cli-publish` | Gemini Enterprise registration |\n| `google-agents-cli-observability` | Observability — Cloud Trace, logging, third-party integrations |\n\n---\n\n## CLI Commands\n\n| Command | What it does |\n|---------|-------------|\n| `agents-cli setup` | Install CLI + skills to coding agents |\n| `agents-cli create <name>` | Create a new agent project |\n| `agents-cli eval run` | Run the agent over the eval dataset and grade the traces |\n| `agents-cli deploy` | Deploy to Google Cloud |\n| `agents-cli publish gemini-enterprise` | Register with Gemini Enterprise |\n\n<details>\n<summary>See all commands</summary>\n\n| Command | Description |\n|---------|-------------|\n| `agents-cli login` | Authenticate with Google Cloud or AI Studio |\n| `agents-cli login --status` | Show authentication status |\n| **Scaffold** | |\n| `agents-cli create <name>` | Create a new agent project |\n| `agents-cli scaffold enhance` | Add deployment or CI/CD to an existing project |\n| `agents-cli scaffold upgrade` | Upgrade project to a newer agents-cli version |\n| **Develop** | |\n| `agents-cli run \"prompt\"` | Run agent with a single prompt |\n| `agents-cli install` | Install project dependencies |\n| `agents-cli lint` | Run code quality checks (Ruff) |\n| **Evaluate** | |\n| `agents-cli eval run` | Run agent inference and grade the traces |\n| `agents-cli eval generate` | Run agent inference over eval cases |\n| `agents-cli eval grade` | Grade generated traces against metrics |\n| `agents-cli eval dataset synthesize` | Synthesize multi-turn eval scenarios for your local agent |\n| `agents-cli eval compare` | Compare two eval result files |\n| `agents-cli eval analyze` | Cluster failure modes from grade results |\n| `agents-cli eval metric list` | List available metrics |\n| `agents-cli eval optimize` | Auto-tune agent prompts using eval data |\n| **Deploy & Publish** | |\n| `agents-cli deploy` | Deploy to Google Cloud |\n| `agents-cli publish gemini-enterprise` | Register with Gemini Enterprise |\n| `agents-cli infra single-project` | Provision single-project infrastructure |\n| `agents-cli infra cicd` | Set up CI/CD pipeline + staging/prod infrastructure |\n| **Other** | |\n| `agents-cli info` | Show project config and CLI version |\n| `agents-cli update` | Force reinstall skills to all IDEs |\n\n</details>\n\n## How it works\n\n<div align=\"center\">\n  <a href=\"https://youtu.be/ECYKo70pPNc\">\n    <img src=\"https://img.youtube.com/vi/ECYKo70pPNc/maxresdefault.jpg\" alt=\"agents-cli demo video\" width=\"100%\" />\n  </a>\n</div>\n\n---\n\n## Architecture\n\nThe Google Cloud agent stack that `agents-cli` builds on:\n\n![Architecture](https://raw.githubusercontent.com/google/agents-cli/main/docs/src/assets/architecture.png \"Architecture\")\n\n## FAQ\n\n**Is this an alternative to Antigravity CLI, Claude Code, or Codex?**<br>\nNo. **`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.\n\n**How is this different from just using `adk` directly?**<br>\n[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.\n\n**Do I need Google Cloud?**<br>\nFor 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.\n\n**Can I use this with an existing agent project?**<br>\nYes. `agents-cli scaffold enhance` adds deployment and CI/CD to existing projects.\n\n**Can I use `agents-cli` without a coding agent?**<br>\nYes. 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.\n\n**How can I extend `agents-cli` with other skills?**<br>\n`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).\n\n## Feedback\n\nWe value your input — it helps us improve `agents-cli` for the community.\n\n- **Bugs & feature requests:** [open an issue](https://github.com/google/agents-cli/issues/new) — 👍 the ones you want prioritized\n- **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\n\n## Contributing\n\nThe 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.\n\nSee the [contributing guide](CONTRIBUTING.md) for details.\n\n## Terms of Service\n\n`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.\n",
  "bytes": 8655,
  "sha": "5f1b4b203a60ad9a89e8c9a8410c769bd940d2c95ee2a1f9f33352880368a69e",
  "repo_slug": "google/agents-cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_google_agents_cli_google_agents_cli_adk__990fa1a0/readme"
}