google-github-actions/run-gemini-cli

这是什么？

核心功能

• 01可在新建 Issue 或 PR 等事件触发时，或按计划自动运行。
• 02在 Issue 和 PR 评论中提及 @gemini-cli 即可按需调用。
• 03模型可在任务中调用 GitHub CLI（gh）等工具。
• 04读取仓库中的 GEMINI.md 文件以获取项目专属指令。
• 05支持 Gemini API 密钥、Vertex AI 和 Workload Identity Federation 认证。

适用场景

• 在 PR 创建时自动进行代码审查。
• 在 Issue 创建时或每晚定时对 Issue 进行分流。
• 在 Issue 或 PR 评论中让 Gemini 解释代码、提出修改建议或编写测试。
• 将工作流遥测数据发送到 Google Cloud 项目以便监控。

快速上手

1. 1

   从 Google AI Studio 获取 Gemini API 密钥

2. 2

   将密钥添加为仓库机密，名称为 GEMINI_API_KEY

3. 3

   启动 Gemini CLI 并运行设置命令以创建工作流

   gemini
4. 4

   在 Gemini CLI 中输入 /setup-github，然后打开拉取请求或在评论中提及 @gemini-cli 进行测试

使用前须知

• !需要将 Gemini API 密钥存储为 GitHub 机密，或为 Vertex AI 配置 Google Cloud。
• !默认的 gemini_cli_version 为 latest，因此除非固定版本，否则 CLI 的行为可能在不同运行之间发生变化。

标签

常见问题

run-gemini-cli 是什么？

一个在 GitHub 仓库中运行 Gemini CLI 的 Action，可用于审查 PR、分流 Issue 并响应 @gemini-cli 指令。 run-gemini-cli 是一个 GitHub Action，可在 GitHub 工作流中运行 Gemini CLI。它既能按计划或事件自动执行任务，也能在 Issue 或 PR 评论中被 @gemini-cli 提及后按需响应。

run-gemini-cli 可以免费使用吗？用的什么许可证？

run-gemini-cli 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

run-gemini-cli 还在维护吗？

半年内有更新。run-gemini-cli 最近一次提交是在 2026年8月21日。

run-gemini-cli 适合用来做什么？

在 PR 创建时自动进行代码审查。 在 Issue 创建时或每晚定时对 Issue 进行分流。 在 Issue 或 PR 评论中让 Gemini 解释代码、提出修改建议或编写测试。 将工作流遥测数据发送到 Google Cloud 项目以便监控。

run-gemini-cli 怎么安装和运行？

从 Google AI Studio 获取 Gemini API 密钥 将密钥添加为仓库机密，名称为 GEMINI_API_KEY 启动 Gemini CLI 并运行设置命令以创建工作流: gemini 在 Gemini CLI 中输入 /setup-github，然后打开拉取请求或在评论中提及 @gemini-cli 进行测试

在哪里获取 run-gemini-cli？

源代码和安装说明在 GitHub 上：https://github.com/google-github-actions/run-gemini-cli