gemini-cli （Gemini 终端 AI 助手）

google-gemini/gemini-cli

去点 Star

开发者工具 AI 应用与 AI Agent 效率与办公工具 ai ai-agents cli gemini gemini-api mcp-client

108,765

Stars

14,925

Forks

583

Watchers

726

Open Issues

Apache-2.0

许可证

TypeScript

语言

2025-04-17

创建时间

2026-11-10

项目能做什么

开源命令行 AI Agent，将 Google Gemini 的能力直接带入终端。

来源：基于仓库元数据 · 内容以仓库实际 README 为准

使用说明查看原始 README 原仓库文档

项目简介

Gemini CLI（命令为 gemini）是一个开源的终端 AI Agent，旨在将 Google Gemini 的能力直接引入命令行。目前该项目主要面向 Google Cloud 上使用 Gemini Code Assist 企业工作流的开发者与组织进行维护。

适合谁用

在安装前请注意，Google 目前对终端工具进行了分工，本项目不适用于所有开发者：

适用对象：
- 拥有 Google Cloud 上的 Gemini Code Assist Standard / Enterprise 许可或 Code Assist for GitHub 的企业用户。
- 拥有旧版付费 API / Vertex AI 密钥的用户。
不适用对象：
- 免费个人用户 / Google AI Pro / Ultra (Google One) 用户：相关支持已于 2026 年 6 月 18 日迁移至 Antigravity CLI（命令为 agy）。
- Gemini 4 系列模型尝鲜者：本项目未针对 Gemini 4（如 Gemini 4 Argon）及后续版本进行优化；体验新模型推荐使用 Antigravity CLI。
- 模型基准评测：请勿使用本项目对 Gemini 模型进行跑分测试，其 Harness 未针对新模型调优，测试结果不具代表性。
- 脚本/CI 自动化 API 调用：推荐使用无状态的 Gemini API CLI（命令为 gemini-api）。

核心功能

代码理解与生成：
- 查询与编辑大型代码库。
- 支持多模态输入，可根据 PDF、图片或手绘草图直接生成应用。
- 使用自然语言辅助调试（Debug）与故障排查。
自动化与生态集成：
- 自动化运维与开发任务（如查询 Pull Request、处理复杂的 Rebase 等）。
- 支持 MCP（Model Context Protocol）服务器扩展能力（如连接 Imagen、Veo、Lyria 等生成多媒体内容）。

安装步骤

快速使用

使用 npx 免安装运行： bash npx @google/gemini-cli

全局安装

npm 安装： bash npm install -g @google/gemini-cli
Homebrew 安装（macOS/Linux）： bash brew install gemini-cli
MacPorts 安装（macOS）： bash sudo port install gemini-cli
Anaconda 环境安装（适用于受限环境）： ```bash # 创建并激活包含 nodejs 的新环境 conda create -y -n gemini_env -c conda-forge nodejs conda activate gemini_env

在环境内全局安装 Gemini CLI

npm install -g @google/gemini-cli ```

选择发布版本通道（Release Channels）

稳定版（Stable，默认推荐）：每周二 UTC 20:00 发布。 bash npm install -g @google/gemini-cli@latest
预览版（Preview）：每周二 UTC 23:59 发布，可能包含未完全验证的功能或回退问题。 bash npm install -g @google/gemini-cli@preview
每日构建版（Nightly）：每日 UTC 00:00 构建主分支最新代码。 bash npm install -g @google/gemini-cli@nightly

配置说明

此部分原文未说明，请查看原仓库。

常见问题

Q: 个人免费账号或 Google One 订阅可以使用 Gemini CLI 吗？
A: 不能。免费层及 Google AI Pro / Ultra 订阅支持已迁移，建议下载并使用 Antigravity CLI (agy)。
Q: 可以用它来给 Gemini 模型跑性能测试（Benchmark）吗？
A: 不建议。官方明确指出其测试工具未针对 Gemini 4+ 进行优化，测出的分数无法代表模型真实水平。
其他问题：此部分原文未说明，请查看原仓库。

原始 README 摘录（英文原文，节选前 3000 字符）

# Gemini CLI

[![Gemini CLI CI](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml)
[![Gemini CLI E2E (Chained)](https://github.com/google-gemini/gemini-cli/actions/workflows/chained_e2e.yml/badge.svg)](https://github.com/google-gemini/gemini-cli/actions/workflows/chained_e2e.yml)
[![Version](https://img.shields.io/npm/v/@google/gemini-cli)](https://www.npmjs.com/package/@google/gemini-cli)
[![License](https://img.shields.io/github/license/google-gemini/gemini-cli)](https://github.com/google-gemini/gemini-cli/blob/main/LICENSE)
[![View Code Wiki](https://assets.codewiki.google/readme-badge/static.svg)](https://codewiki.google/github.com/google-gemini/gemini-cli?utm_source=badge&utm_medium=github&utm_campaign=github.com/google-gemini/gemini-cli)

<!-- prettier-ignore -->
> [!IMPORTANT]
> **Read before installing — Gemini CLI status & tool guide**
>
> - **Enterprise Code Assist only:** Designed for **Gemini Code Assist Standard / Enterprise** licenses and **Code Assist for GitHub** on Google Cloud (your access remains unchanged).
> - **No free tier or Google AI plans:** Free individual access and **Google AI Pro / Ultra** (Google One) moved to [Antigravity CLI](https://antigravity.google/product/antigravity-cli) on June 18, 2026 ([transition post](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)).
> - **Not optimized for Gemini 4+:** Not tuned for the **Gemini 4** series (for example, [Gemini 4 Argon](https://blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-argon/)) or future releases in this or later generations.
> - **Not for model benchmarks:** Don't use Gemini CLI to benchmark Gemini models—its harness isn't tuned for Gemini 4+ and produces unrepresentative scores.
>
> **Which Google CLI do you need?**
>
> | Tool | Best for | Links |
> | :--- | :--- | :--- |
> | **[Antigravity CLI](https://antigravity.google/product/antigravity-cli)** (`agy`) | Interactive multi-agent coding terminal. Use for **Gemini 4 Argon**+, free / **Google AI Pro & Ultra** accounts, or Google Cloud. | [Download](https://antigravity.google/download) · [Migrate](https://antigravity.google/docs/cli/gcli-migration) · [Argon post](https://antigravity.google/blog/gemini-4-argon-in-google-antigravity) |
> | **[Gemini API CLI](https://github.com/google-gemini/gemini-api-cli)** (`gemini-api`) | Stateless API CLI *(not a coding harness)*. Gives agents (`agy`, Claude Code, Codex), scripts, and CI direct commands for Gemini models, media gen, file analysis, and managed agents. | [GitHub](https://github.com/google-gemini/gemini-api-cli) · [Releases](https://github.com/google-gemini/gemini-api-cli/releases) · [API docs](https://ai.google.dev/gemini-api/docs) |
> | **Gemini CLI** (`gemini`, *this repo*) | Organizations with **Gemini Code Assist Standard / Enterprise** or **Code Assist for GitHub** on Google Cloud *(

阅读完整原文

商业机会分析规则生成（AI 未配置）

综合评分 70.7 分。该项目在“个人可实施性”维度得 52 分，“付费可能性”维度得 84.0 分，差异化空间 70.0 分（评分依据见评分卡）。

将 gemini-cli 改造为垂直场景 SaaS

产品构想	保留核心能力，针对某一类用户（如某行业团队）做托管版，收取月费。
目标用户	有该需求的中小团队 / 独立站长
难度/周期	中 · 2~4 周（MVP）
收费模式	订阅制（如 ¥29~99/月）
竞争风险	需验证付费意愿；注意许可证合规
依据	数据支持的判断：许可证与关键词显示存在商用与付费场景

面向细分需求的二次开发产品

产品构想	基于 gemini-cli 的核心能力，聚焦一个更窄的场景（如某平台、某行业）做差异化。
目标用户	该细分场景用户
难度/周期	中 · 2~6 周
收费模式	买断制 / 订阅制 / 广告
竞争风险	细分需求规模需验证
依据	AI 推测：基于项目主题标签的判断

封装为在线小工具或 API 服务

产品构想	把项目最常用的一个功能做成网页小工具，靠流量变现或按量计费。
目标用户	搜索引擎带来的长尾用户
难度/周期	低 · 1~3 周
收费模式	免费引流 + 增值功能 / API 按量计费
竞争风险	同质化竞争，需做好 SEO
依据	AI 推测：基于技术栈与部署特征的判断

以上为规则引擎基于仓库公开数据生成的参考结论，包含推测成分，不构成投资或创业承诺；配置 AI 后可获得更深入的分析。

报告会保存到个人中心

竞品与相似项目 GitHub Search 真实检索

项目	中文简介	Stars	语言
morluto/rea	中文介绍暂未生成 Reverse engineer anything with agents, from app behavior dow	449,729	TypeScript
openclaw/openclaw	中文介绍暂未生成 The AI that really does things. Any OS. Any Platform. The lo	394,300	TypeScript
obra/superpowers	中文介绍暂未生成 An agentic skills framework & software development methodolo	315,709	Shell
NousResearch/hermes-agent	中文介绍暂未生成 The agent that grows with you	262,418	Python
n8n-io/n8n	中文介绍暂未生成 Fair-code workflow automation platform with native AI capabi	210,016	TypeScript
firecrawl/firecrawl	中文介绍暂未生成 Supercharge your AI agents with data from the web and beyond	200,488	TypeScript

以上为通过 GitHub 官方 Search API 检索的相似项目，功能差异与优劣势需进一步人工确认，配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度	创建于 2025-04-17，近 30 天仍在推送，发布过 100 个 Release
社区活跃	Star 108,765 / Fork 14,925 / Issue 726（数据支持，可自行核实）
许可证	Apache-2.0
主要风险	上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价

安装与使用

快速开始（以仓库 README 为准）

git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
# 请阅读仓库 README 获取确切安装步骤（依赖、配置、启动命令）

阅读原仓库文档

术语说明：Docker＝应用容器（把程序和依赖打包运行）；API Key＝调用外部服务的密钥；Git Clone＝把仓库代码下载到本地。常见错误：API Key 未配置 / 端口占用 / 数据库连接失败，多数项目在 README 的 Troubleshooting 章节有说明。

技术要求与部署

部署难度	中等
Docker	未提供（参考 README）
API Key	需要
独立数据库	不需要
GPU	不需要
本地运行	一般可行
预计成本	入门级云主机（1~2 核 1~2GB）或本地运行即可，无需昂贵服务器

由规则引擎基于 README 关键词推断，以仓库实际要求为准。

商业潜力评分 70 / 100

实际需求与应用场景 20% 90

市场付费可能性 20% 84

个人开发者可实施性 20% 52

产品差异化空间 15% 70

项目成熟度 10% 50

部署与运营成本 10% 50

社区活跃度 5% 100

展开评分依据

实际需求与应用场景（90 分）

· Star 数 108,765（对数刻度映射，Star≠付费意愿）

· 主题/描述命中需求关键词：agent, ai

· 最近 0 天有代码更新，处于活跃维护状态

市场付费可能性（84 分）

· 许可证 apache-2.0 允许闭源商用，可二次开发为收费产品

· 与付费场景相关关键词：agent, api

· 项目有官网/演示站，说明作者重视产品化

个人开发者可实施性（52 分）

· 主要语言 TypeScript，生态成熟、个人可掌握

· 依赖外部 API Key：有持续的 API 成本

· 部署难度评估：中等

产品差异化空间（70 分）

· 项目已是头部，直接复制竞争激烈，需找细分场景

· 细分主题标签 5 个，存在垂直切入角度

项目成熟度（50 分）

· 项目创建于 572 天前，已度过早期不稳定期

· 近 30 天仍在推送代码

部署与运营成本（50 分）

· 依赖付费 API 时存在持续成本

· 运行成本评估：入门级云主机（1~2 核 1~2GB）或本地运行即可，无需昂贵服务器

社区活跃度（100 分）

· Fork 14,925 / Issue 726，社区参与度可查

数据更新时间：2026-11-10 · 规则透明可复算，Star 数仅作为需求信号之一，不代表付费意愿。

Star 增长曲线（采集快照）

最近 19 次采集快照 · 2026-11-10 ~ 2026-11-10