agents-cli logo

agents-cli

The CLI and skills for building agents on Gemini Enterprise Agent 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 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:** [Antigravity CLI](https://antigravity.google/)  •  [Claude Code](https://docs.anthropic.com/en/docs/claude-code)  •  [Codex](https://github.com/openai/codex)  •  *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 ```
Or just the skills — your coding agent will handle the rest ```bash npx skills add google/agents-cli ```
### 2. Open your coding agent 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. ### 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 ` | 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 |
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 ` | 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 |
## How it works
agents-cli demo video
--- ## 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 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](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?**
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?**
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](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 agents-cli@google.com 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. 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).