README

agents-cli
  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

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, 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 |
| 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 in Gemini platform, Cloud Run, GKE, CI/CD, secrets |
| google-agents-cli-publish | Gemini 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 create  -y | 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  -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 scaf