google-gemini/gemini-cli

项目概览

已提供 MCP 扩展、非交互式脚本运行和终端内置工具，可验证其是否正从交互式编码助手扩展为通用终端自动化组件。

项目类型

MCP · AI Agent · AI 编程

应用场景

文档办公 · 编程开发

部署方式

查看项目说明

License

Apache-2.0

适合谁

• 长期在命令行中工作，希望通过自然语言交互调用 Gemini 代码理解、生成与调试能力的开发者。
• 需要把智能代理嵌入脚本，自动处理拉取请求查询、复杂变基等工程任务的团队。
• 需要通过 MCP 服务器接入自定义工具，并用项目上下文文件适配不同仓库规则的团队。

核心能力

• 可查询和编辑大型代码库，以自然语言辅助定位及调试问题，并利用多模态能力从 PDF、图片或草图生成新应用。该能力已可用，主要价值是把代码分析、修改和新项目生成统一到终端交互中。
• 可执行查询拉取请求、处理复杂变基等操作任务，也能以非交互方式嵌入脚本。该能力已可用，适合把自然语言驱动的操作从人工会话迁移到可重复运行的流程。
• 集成文件操作、Shell 命令和网页获取能力，使智能代理能够读取环境并执行实际操作，而不只是返回建议文本。该能力已可用，是形成终端任务闭环的基础。
• 可通过 MCP 服务器接入自定义集成，将项目能力扩展到内置工具之外。该能力已可用，适合需要连接团队专用工具或外部系统的场景。
• 可保存并恢复复杂会话，使中断后的任务能够继续推进。该能力已可用，对长链路排障、跨阶段修改和需要保留上下文的工作尤其有价值。
• 可使用 GEMINI.md 自定义上下文文件，使工具行为适配具体项目。该能力已可用，可用于持续提供仓库相关背景，降低反复输入项目约束的成本。

限制与风险

• 预览版和每夜构建可能包含功能回归或尚未解决的问题；用于关键流程时应区分发布通道，并在升级前完成回归验证。
• 本地运行的是命令行程序，核心模型能力仍需要外部 Google Gemini API，因此无法仅凭本地可运行属性满足完全离线或封闭网络要求。
• 项目提供免费层访问，但付费服务属于可选依赖；团队应根据实际使用方式确认免费层是否足够，而不能将开源命令行工具等同于无服务成本。
• 现有资料未明确记录 GPU、最低硬件和操作系统要求，受限环境或大规模推广前需要自行完成目标环境验证。

如何开始

• 可直接运行 npx @google/gemini-cli，无需预先全局安装，适合先验证终端交互和项目适配度。
• 也可通过 npm 完成全局安装，随后在终端执行 gemini 命令进入使用流程。
• 首次成功路径要求使用 Google 账号或 API Key 完成认证；团队推广前应先确定统一的认证方式，并结合外部服务依赖评估数据边界。

核验依据

• GitHub 项目简介: An open-source AI agent that brings the power of Gemini directly into your terminal.
• README: 🔧 Built-in tools**: Google Search grounding, file operations, shell commands, web fetching. - **🔌 Extensible**: MCP (Model Context Protocol) support for custom integrations. - **💻…
• README: New preview releases will be published each week at UTC 23:59 on Tuesdays. These releases will not have been fully vetted and may contain regressions or other outstanding issues.
• README: New stable releases will be published each week at UTC 20:00 on Tuesdays, this will be the full promotion of last week's `preview` release + any bug fixes and validations.
• README: - Query and edit large codebases - Generate new apps from PDFs, images, or sketches using multimodal capabilities - Debug issues and troubleshoot with natural language

内容核验时间：