google-github-actions/run-gemini-cli

What is it?

Key features

• 01Runs automatically on events such as newly opened issues or pull requests, or on a schedule.
• 02Responds to @gemini-cli mentions in issue and pull request comments.
• 03Lets Gemini call tools such as the GitHub CLI (gh) during a task.
• 04Reads a GEMINI.md file for project-specific instructions and context.
• 05Supports Gemini API key, Vertex AI, and Workload Identity Federation authentication.

Use cases

• Automatically reviewing pull requests when they are opened.
• Triaging new GitHub issues on creation or on a nightly schedule.
• Asking Gemini to explain code, suggest changes, or write tests from an issue or PR comment.
• Sending workflow telemetry to a Google Cloud project for monitoring.

Quick start

1. 1

   Get a Gemini API key from Google AI Studio

2. 2

   Add the key as a repository secret named GEMINI_API_KEY

3. 3

   Start the Gemini CLI and run the setup command to create the workflows

   gemini
4. 4

   In the Gemini CLI, type /setup-github, then open a pull request or mention @gemini-cli in a comment to try it

Things to know

• !Requires a Gemini API key stored as a GitHub secret, or a Google Cloud setup for Vertex AI.
• !The default gemini_cli_version is latest, so the CLI behavior may change between runs unless you pin a version.

Topics

FAQ

What is run-gemini-cli?

A GitHub Action that runs the Gemini CLI inside your repository to review pull requests, triage issues, and handle @gemini-cli requests. run-gemini-cli is a GitHub Action that runs the Gemini CLI inside GitHub workflows. It can work autonomously on scheduled or event-driven tasks, or act as an on-demand assistant when someone mentions @gemini-cli in an issue or pull request comment.

Is run-gemini-cli free to use? What license does it have?

run-gemini-cli is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.

Is run-gemini-cli still maintained?

Updated within 6 months. The last commit to run-gemini-cli was on Aug 21, 2026.

What can I use run-gemini-cli for?

Automatically reviewing pull requests when they are opened. Triaging new GitHub issues on creation or on a nightly schedule. Asking Gemini to explain code, suggest changes, or write tests from an issue or PR comment. Sending workflow telemetry to a Google Cloud project for monitoring.

How do I install run-gemini-cli?

Get a Gemini API key from Google AI Studio Add the key as a repository secret named GEMINI_API_KEY Start the Gemini CLI and run the setup command to create the workflows: gemini In the Gemini CLI, type /setup-github, then open a pull request or mention @gemini-cli in a comment to try it

Where can I get run-gemini-cli?

The source code and installation instructions are on GitHub: https://github.com/google-github-actions/run-gemini-cli