Run Gemini CLI workflow
run-gemini-cli
Google's official action for GitHub Actions: runs Gemini CLI in a repository to review pull requests, triage issues and edit code
- 2,104 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- Edits the repository and leaves comments in the name of a bot
- The model key secret is stored in the repository settings
- Model calls are paid
Install
Manual install
Connect the google-github-actions/run-gemini-cli action in the workflow per the README and connect the GEMINI_API_KEY secret from the repository settings. The owner creates the key. Limit the token permissions to the needed ones.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Edits the repository and leaves comments in the name of a bot
- The model key secret is stored in the repository settings
- Model calls are paid
This is third-party code. Review the repository files before installing.
What it does
The action runs Gemini CLI right in GitHub Actions. It can review pull requests, triage issues, analyze and edit code, and a call like `@gemini-cli fix this issue` works in a comment. It needs the `GEMINI_API_KEY` secret or a Vertex AI key, and the `gcp_token_format` parameter sets the token format. The action is written in TypeScript, the latest release is v0.1.22 from 24.04.2026, and the repository is in the Google GitHub Actions organization.
Who it is for. For teams that use Gemini and want to automate review and issue triage in GitHub without their own server.
Good fit when
- You need to review pull requests automatically with a Gemini model
- You need to call an agent from an issue comment
- You need to run Gemini CLI in CI instead of a local machine
Not a fit when
- You cannot let a bot change the repository and leave comments
- You need another agent: the action runs Gemini CLI only
Example request
Add a workflow to the repository that runs Gemini CLI on every new pull request and leaves a review as a commentLimitations
The action works in the name of a bot: it edits the repository and leaves comments, so limit the token's permissions and protect branches. The GEMINI_API_KEY secret or a Vertex AI key is needed and model calls are paid at your tariff. Version 0.1.x, so the interface may change. The repository was last updated on 21.08.2026.
How to disable. Remove the action step from the workflow file and delete the GEMINI_API_KEY secret from the repository settings.
FAQ
What does this action do?
It runs Gemini CLI in GitHub Actions: pull request review, issue triage, code analysis and editing.
What is needed to run it?
The GEMINI_API_KEY secret or a Vertex AI key in the repository settings.
How do I call it from a comment?
With a phrase like @gemini-cli fix this issue in an issue comment.
Discussion
No questions or reviews yet.
Related
WorkflowsA gh extension for agentic workflows: describe a task in Markdown and run it with an agent in GitHub Actions
A GitHub Action that runs Claude Code in pull requests and issues: answers mentions, reviews and makes changes
Google Cloud's MCP server and Gemini CLI extension for GKE clusters: resources, logs, deploys, costs and upgrade risks
GitHub's official MCP server: code, issues, pull requests, Actions and security alerts straight from the agent
A self-hosted gateway for multiple LLM keys and providers: rotation, failover, request logs and usage accounting
A git worktree CLI built for running Claude Code and Codex in parallel: the wt command, a plugin, and automation hooks
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Run Gemini CLI (this entry) | yes | 2,104 | ||
| Colab MCP | yes | not required | 1,210 | the official Google Colab server for a browser session |
| Gemma Skills | yes | 1,009 | an official Google skill for developing on Gemma |
README in short
The README describes Google's official action for running Gemini CLI in GitHub Actions: review, issue triage, code editing and a call from a comment. Apache-2.0 license.