KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

agents-cli

★ 5,645 Open GitHub ↗

The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<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">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:**
[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.*

## 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 [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 <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

---

## 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?**<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.

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.

agents-cli

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README